Convertr uses OAuth for it's API authentication. All end points (unless explicitly detailed) require an access_token to be passed through with each request. Tokens expire after 60minutes and need to either be refreshed or a new one generated.
Requesting a token
Request:
| Code Block | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
POST /oauth/v2/token HTTP/1.1 Host: dev{enterprise}.cvtr.io Content-Type: application/x-www-form-urlencoded Cache-Control: no-cache Postman-Token: 255fe433-ff32-4f00-9b4e-dd79a3ceae13 client_id=4_50bb9wpfmj8cwgw8kk8s848ck8s0gkc8wok0wogockwck488o8{your_client_id}& client_secret=zfiacn1uttcsogc0w4wocowgkk0socsggkoo88k8kskws8gc{your_client_secret}& username=danny%40convertrmedia.net{your_email}& password=!LoveC0nvertr{your_password}& grant_type=password |
Response:
| Code Block | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"access_token": "NWY0OWNmZTJlNjA1YWE1ZDY5YjM0NGM2NTg0NjRkN2FiOTRhNWJkNTEzNWUyODM3ZTVmY2M0ZTNjNDM0YWU2ZQ",
"expires_in": 3600,
"token_type": "bearer",
"scope": null,
"refresh_token": "MWI1ZTQ2ODg5NWY2NzY4ZTMzNmJiN2U5MmIxM2YyMGNmMzlhZWQwZTU3OGNjODM2Y2I0NDNhMjdmYWI3NTFhMA"
} |
You will then need to reference the access_token in all subsequent requests with the following url parameter: access_token
In order for you to see additional context about the API end points, it's recommended that you use the .jsonld url extension. This will provide you additional information about the response, such as pagination, total records and next and previous urls.