Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 3 Current »

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:

Access Token
POST /oauth/v2/token HTTP/1.1
Host: {enterprise}.cvtr.io
Content-Type: application/x-www-form-urlencoded

client_id={your_client_id}&
client_secret={your_client_secret}&
username={your_email}&
password={your_password}&
grant_type=password

Response:

Response
{
    "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 with the 

  • No labels