Office for iOS OAuth2 sign-in URL parameters

The HTTPS request to load the OAuth2 Authorization page (RFC 6749#section-3.1) includes standard OAuth2 parameters such as client_id, redirect_uri, etc. but may also include Office-specific parameters, documented here.

Important

Early releases of Office for iOS may not include some or all of these URL parameters, so callers should fall back to reasonable defaults.

Culture

The request includes the Accept-Language header. The value of this header is determined by the iOS language settings. In addition, the following URL parameter is appended to the request URL:

rs=Culture

Culture contains the UI culture of the Office interface, e.g. en-US.

Build

The following URL parameter is appended to the request URL:

build=#

“#” will be a string showing the build of the Office application making the request.

Platform

The platform URL parameter communicates which platform the app is running on.

platform=iOS

Example

Here’s a request to the sign-in endpoint showing all parameters in use:

https://contoso.com/api/oauth2/authorize?&rs=en-US&build=1.21.417&platform=iOS&client_id=abcdefg&redirect_uri=https%3A%2F%2Flocalhost&response_type=code