API endpoints of Office 365 operated by 21Vianet
Applies to: Office 365 for China operated by 21Vianet
For applications of Office 365 operated by 21Vianet in China, the API resources and related services have different URLs from those of other Office 365 offerings. These differences are documented as follows.
Microsoft Graph API
Applications that used Office 365 unified API can now upgrade to use Microsoft Graph(https://graph.microsoft.io/en-us/).
Service root endpoint
| Microsoft Graph operated by 21Vianet | Microsoft Graph |
|---|---|
https://microsoftgraph.chinacloudapi.cn |
https://graph.microsoft.com |
Microsoft Graph Explorer
| Microsoft Graph operated by 21Vianet | Microsoft Graph |
|---|---|
https://graphexplorerchina.azurewebsites.net |
https://graphexplorer2.azurewebsites.net |
Learn more about Microsoft Graph endpoints and service capabilities.
Azure Active Directory Graph API
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://graph.chinacloudapi.cn |
https://graph.windows.net |
Discovery Service API
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
| Not yet enabled | https://api.office.com/discovery |
Discovery service is not needed if calling Microsoft Graph (https://graph.microsoft.com/).
Calendar API
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://partner.outlook.cn |
https://graph.microsoft.comhttps://outlook.office.com |
For example, to get a user's calendars using v2.0 of Office 365 operated by 21Vianet, submit a GET request to https://partner.outlook.cn/api/v2.0/me/calendars.
Contacts API
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://partner.outlook.cn |
https://graph.microsoft.comhttps://outlook.office.com |
For example, to get a users' contacts using v2.0 of Office 365 operated by 21Vianet, submit a GET request to https://partner.outlook.cn/api/v2.0/me/contacts.
Mail API
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://partner.outlook.cn |
https://graph.microsoft.comhttps://outlook.office.com |
For example, to get a user's emails using v2.0 of Office 365 operated by 21Vianet, submit a GET request to https://partner.outlook.cn/api/v2.0/me/messages.
Files API
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://{tenant}-my.sharepoint.cn/_api/v1.0/mehttps://{tenant}.sharepoint.cn/{site-path}/_api/v1.0 |
https://graph.microsoft.comhttps://{tenant}-my.sharepoint.com/_api/v1.0/me (OneDrive for Business)https://{tenant}.sharepoint.com/{site-path}/_api/v1.0 (SharePoint sites) |
Calendar, Contacts, and Mail OData entity
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://partner.outlook.cn/api/{version}/$metadata |
https://graph.microsoft.com/{version}/$metadatahttps://outlook.office.com/api/{version}/$metadata |
Specify the exact version in {version}. For example, the @odata.context for a calendar entity in v2.0 of Office 365 operated by 21Vianet is https://partner.outlook.cn/api/v2.0/$metadata#Me/Calendars/$entity.
Files OData entity
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://{tenantId}-my.sharepoint.cn/_api/v1.0/$metadata |
https://graph.microsoft.com/v1.0/$metadatahttps://{tenantId}-my.sharepoint.com/_api/v1.0/$metadata |
The following sections are related to accounts and authentication.
Microsoft Azure
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://account.windowsazure.cn |
https://account.windowsazure.com |
Go to https://account.windowszaure.cn to set up the development environment for Office 365 operated by 21Vianet. For more information, see Set up your Office 365 development environment.
Azure OpenID Connect and OAuth
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://login.chinacloudapi.cn |
https://login.microsoftonline.com |
Use https://login.chinacloudapi.cn/common/oauth2/authorize to authenticate the user and https://login.chinacloudapi.cn/common/oauth2/token to to acquire a token for your app to
call Office 365 operated by 21Vianet.
Office 365 developer site
In the following URLs, {your-sub-domain} is the name you specify when setting up your developer site.
| Office 365 operated by 21Vianet | Office 365 |
|---|---|
https://{your-sub-domain}.partner.onmschina.cn |
https://{your-sub-domain}.onmicrosoft.com |