![]() |
Page History
...
All service endpoints require Okta access token authentication. To generate an Okta access token, a request must be made to the environment service endpoint using a valid Client ID and Client Secret. See below for additional details on how to construct the access token request.
Method: POST
Service Endpoints:
Int |
...
https://bioappdev.okta.com/oauth2/aus3ym6wniM6O3MGE297 |
...
/ |
...
Production: <Provide Prod URL here>
POST:
...
v1/token | |
Stage | https://bioappdev.okta.com/oauth2/aus478s3eb0x3du23297/v1/token |
...
Production |
Headers
...
Content-Type |
application/x-www-form- |
...
urlencoded | |
Accept | application/json |
Parameters:
...
grant_type |
...
client_credentials |
...
...
Authorization:
Authorization Type | Basic |
clientIdUsername | Client ID generated by CTRP Support for the user account |
clientSecretPassword | Client Secret generated by CTRP Support for the user account |
...
Once the access token has been generated, it will need to be included in the 'Authorization: Bearer' parameter when submitting API requests. The following example uses the accrual-services URL in the Int Stage environment and lists the required header and parameters values.
Method: GET
Service Endpoint:
Stage | https://trials-int.nci.nih.gov/accrual-services/trials/sites/{id} |
{id} | CTRP numeric identifier of a participating site |
curl --location --request GET "https://trials-stage.nci.nih.gov/services/trials/<NCI ID>" \
...
--header "Authorization: Bearer <accessToken>"
Headers
Content-Type | application/json |
Accept | application/xml |
Parameters:
...
Access Token generated in step 3. | NCI ID | Trial ID (e.g NCI-2017-02883) |
Authorization:
Authorization Type | Bearer Token |
Token | Access Token generated in step 3 above |
Response:
JSON or XML data, depending on which service is being used.
...