Overview
This guide is a quick reference that lists the steps for accessing the customer information of the currently logged in user. In USTA parlance, this is 'Bound' access. In this mode, the customer UAID is bound to the session under which the user has logged in to USTA.com. The token will restrict access to only data for this one UAID.
...
It should be noted that the best use of this API is within the context of a browser-based application. Because the customer UAID is bound to the token, it is safe to store in a cookie.
JanRain Test Account
For the purpose of testing, we have created a dummy Janrain client id for use against the non-prod platform.
| Field | Value |
|---|---|
| client_id | afwu4zrn4caebfaf9d375vb5tvee5es5 |
| secret | Usta@1234 |
Step 1: Retrieve a Identity Token
...
This is the API call. Janrain only has two environments. Please note the difference in base urls:
Test: https://usta-dev.us-dev.janraincapture.com
Prod: https://usta-prod.us.janraincapture.com
Data/Payload
You must use the client_id and currentPassword assigned by USTA. The signInEmailAddress is your unique user identity at Janrain.
...
| Key | Value |
|---|---|
| client_id | <YOUR ASSIGNED JANRAIN CLIENT ID> |
| currentPasswordsignInEmailAddress | <YOUR UNIQUE JANRAIN PASSWORD>EMAIL ADDRESS> |
| signInEmailAddresscurrentPassword | <YOUR UNIQUE EMAIL ADDRESS>JANRAIN PASSWORD> |
| flow | standard |
| flow_version | 20161114171439489756 |
| redirect_uri | http://localhost |
| response_type | token |
| form | signInForm |
| locale | en-US |
...
This API call uses Basic Authorization. Use the supplied client_id and secret to generate a Basic Authentication token. There are many online generators you can use for testing. One is here.
| Key | Value |
|---|---|
| authorization | 'Basic [SUPPLY YOUR GENERATED BASIC AUTHENTICATION TOKEN]' |
...
This is the API call. Please note the difference in base urls:
Test: https://stage-services.usta.com
Prod: https://services.usta.com
Result
The important info returned from this call are the following:
...
For instance, you can retrieve your Customer Profile information using the following API call: https://stage-services/v1/customer/me
Headers
| Key | Value |
|---|---|
| Content-Type | application/json |
| authorization | 'Bearer ZTc2ZGQxZWItZjVjMC00MDFiLWFjYTktZWYxZGRlNTcyYzg4OkhOOUU2U2ovdmtWUWEyR2pKYUxBSDF4WndWTzN0dHZWQmJRQnpRaVlpbWc1RWFvVVJ5bUVhTzc4SVRtNVh5NjQzSUo0UThTcHpTNXQ2c2Jz' |
...