Step 1: Authentication
Environments
There are two different environments available to partners. Each environment uses a different base URL.
- Sandbox:
https://api.sandbox.tripleup.dev/
- Production:
https://api.tripleup.dev/
Authentication
Triple uses OAuth for authentication (machine-to-machine/server-to-server).
After succesful onoboarding your Triple contact will have provided you with the clientId
and clientSecret
for both sandbox and production environments.
User the clientId
and clientSecret
to obtain an access_token
. By default, the access_token
is valid for 3,600s
curl --location 'https://auth.tripleup.dev/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic {clientId}:{clientSecret}' \
--header 'Cookie: XSRF-TOKEN=5b367412-3873-499a-b615-d5661505de5e' \
--data-urlencode 'grant_type=client_credentials'
tip
Note the usage of Content-Type: application/x-www-form-urlencoded
and the body of grant_type=client_credentials
Conventions
Action | Description |
---|---|
GET | Used to retrieve a representation of a resource. |
POST | Used to create new resources and sub-resources. |
PATCH | Used to update existing resources. |
DELETE | Used to delete existing resources. |