Authentication

Without an authorized ArcGIS Online account, you can only access public data through the Urban API. Use an access token to access private data associated with an account, organization, or group.

The Urban API uses the ArcGIS Online authentication workflows to authenticate a user.
Familiarize yourself with authentication in ArcGIS Online to understand how to handle authentication in your applications.

There are several methods for authentication but OAuth2 is probably the most common one. You can use the OAuth2 endpoints directly, as described in the OAuth2 documentation. You can also use a helper library such as ArcGIS REST JS (Javascript).

Access token

Get the access token authenticating an ArcGIS Online user by following the instructions in the section above.

Then, authenticate the user by adding the access token to the request's authorization header:
Authorization: Bearer ACCESS_TOKEN

You can authenticate a user regardless of how you interact with the Urban API. See the sections below to learn how to use access tokens with cURL or the GraphQL Playground.

Authentication with cURL

Authenticate the user through the cURL command by adding the access token to the request's authorization header:

1
2
3
4
5
6
curl \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  --data '{ "query": "{ urbanModels { id title } }" }' \
  https://urban-api.arcgis.com/graphql

Authentication in the GraphQL Playground

Authenticate the user in the GraphQL Playground by adding the following content to the HTTP Headers tab:

1
2
3
{
  "Authorization": "Bearer ACCESS_TOKEN"
}