The Socrata Open Data API uses application tokens for two purposes:
The default throttling quota when using an application token is 1000 requests, per IP address, per token, per hour. If you exceed that limit, you will receive a status code
You can obtain an application token by registering your application in your Socrata profile. After creating the application, click on App Tokens in the left-hand navigation bar. The application token will be visible.
While it is possible to perform simple unauthenticated queries against the Socrata Open Data API without making use of an application token, you’ll receive much higher throttling limits if you include an application token in your requests. If you elect not to use an application token, you’ll be subjected to a much lower throttling limit for all requests originating from your IP address.
There are two ways to include the application token in the request:
- Use the
X-App-Token HTTP header.
- Use the
$$app_token parameter in your request (
app_token if you’re using old SODA 1.0 APIs).
Using the header is the preferred method.
HTTPSrequests. If your application token is duplicated by another developer, their requests will count against your quota.
The following is an example of using the
X-App-Token HTTP header to pass an application token:
The same application token could also be passed as a URL parameter:
Application tokens can also be used for authentication, using OAuth2.0 or HTTP Basic Authentication. For more information, see the authentication section.