Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The USTA API provides a toolkit for accessing USTA data from properly credentialed partner applications.  The API is organized around RESTRESTful calling style that works with standard HTTP calls.  All requests should be made over SSL.  All requests and responses as well as errors are encoded in JSON.  This document provides developers with an introduction to integrating your application with the USTA API.

Credentials

The USTA must issue credentials prior to using the API.  I you require credentials, please contact USTA.

Rate Limiting

The USTA institutes per-month, per-hour, per-minute, and per-IP rate limits for each API method, and limits API users to a maximum of five concurrent connections from a single IP address. Our default limits are more than sufficient for nearly all use cases.  Please be mindful of these limits.  

Rate limited calls may result in HTTP error status 403 responses.

Lookup Behavior

Standard behavior when looking up elements in the API result in HTTP error status 404 NOT FOUND when an element does not exist.  In some cases, an API can result in HTTP status 200 where the result will contain an empty result set. Where the behavior deviates, the API reference will denote the behavior,

Error Codes

The USTA API follows standard HTTP error status protocols.  Please note that all valid responses will return an HTTP status code of 200.

You can see the complete list of error codes here.

...