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 |
|---|
| language | bash |
|---|
| theme | Midnight |
|---|
| firstline | 1 |
|---|
| title | Access Token |
|---|
| linenumbers | true |
|---|
|
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 |
|---|
| language | bash |
|---|
| theme | Midnight |
|---|
| firstline | 1 |
|---|
| title | Response |
|---|
| linenumbers | true |
|---|
|
{
"access_token": "NWY0OWNmZTJlNjA1YWE1ZDY5YjM0NGM2NTg0NjRkN2FiOTRhNWJkNTEzNWUyODM3ZTVmY2M0ZTNjNDM0YWU2ZQ",
"expires_in": 3600,
"token_type": "bearer",
"scope": null,
"refresh_token": "MWI1ZTQ2ODg5NWY2NzY4ZTMzNmJiN2U5MmIxM2YyMGNmMzlhZWQwZTU3OGNjODM2Y2I0NDNhMjdmYWI3NTFhMA"
} |