API endpoints of Office 365 operated by 21Vianet

2016-04-19

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.com` `https://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.com` `https://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.com` `https://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/me` `https://{tenant}.sharepoint.cn/{site-path}/_api/v1.0`	`https://graph.microsoft.com` `https://{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}/$metadata` `https://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/$metadata` `https://{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`

Share via