Authentication Request

Before you can access any API resources you will need to authenticate yourself by providing your username and password to an authentication endpoint. If successful, the endpoint will return an authorization token, which needs to be provided in all subsequent API calls. The token can be used to access resources from all networks in line with your users access level.

Auth call request

curl -b cookies -c cookies -H "Content-Type: application/json" -d'{"username": "your_username", "password":"your_password"}' -X POST "http://asx-api.bidtheatre.com/v2.0/api/auth"

Auth call response

{
    "apiVersion": 2,
    "code": 200,
    "method": "POST",
    "auth": {
        "role": "campaign_manager",
        "refreshTokenTtl": 604800,
        "fullName": "Your Name",
        "refreshTokenCount": 0,
        "ttl": 3600,
        "email": "[email protected]",
        "token": "2326CED835497C89B9D9BB6E44A293D3514D722F",
        "username": "your_username",
        "refreshToken": "8666B60EF5C908B6302F7E5D405FB50BA7ED75B0"
    }
}

📘

The token is valid for one (1) hour before it expires.

If a new login attempt is made when a valid token is still available the old token will be reused. To force the generation of an new token, set the forceNewToken to true as indicated below.

Text

curl -b cookies -c cookies -H "Content-Type: application/json" -d'{"username": "your_username", "password":"your_password", "forceNewToken":true}' -X POST "http://asx-api.bidtheatre.com/v2.0/api/auth"