pre-requisites

• Authentication

Overview

Authentication provides who the requesting user is, while Authorization provides what the requesting user has access to. Authorization is required in order to use any of the external APIs. The authorization endpoint provides the API user with the partners and advertisers they have access to within ui.marketing. The authorized partners will have an authorizationId associated with it that can be retrieved from the API response. From there, permitted advertisers can be retrieved. This authorizationId will be needed for all other external APIsGet all authorizations the authenticated user has access to.

Endpoint

...

"authorizations": [
  {
    "name": "The Best Partner",
    "authorizationId": "891bb822-2d25-4128-8994-001c1b0044a3",
    "advertisers": [
      {
        "id": 456,
        "name": "Advertiser 1"
      },
      {
        "id": 789,
        "name": "Advertiser 2"
      },
      {
        "id": 123,
        "name": "Advertiser 3"
      }
    ]
  }
]

Header Specifications

• Authorization

Input Specifications

• N/A

Output Specifications

• A list of authorizations

  • see: Authorization Response

...