Totogi Marketplace connects communications service providers with pre-negotiated & highly valuable offers from digital service providers to incorporate into product offerings, promotions and bundles via this single and unified API.

Authentication

Before calling the API, obtain an access token from https://oauth.totogi.io/oauth2/token You will need your API Key and Secret Key, which you can find on the Marketplace Profile Page To obtain the token:

1. Concatenate your API Key and your Secret Key with a colon separator
2. Base64 the concatenated value
3. Make an HTTP POST call to the TOKEN endpoint
4. Here's an example of the entire process in a single Python utility function that returns the token:

def get_marketplace_token(api_key: str, api_secret: str) -> str:
    CREDENTIAL_BYTES = str(api_key + ":" + api_secret).encode("ascii")
    CREDENTIAL_B64 = base64.b64encode(CREDENTIAL_BYTES).decode()
    headers = {
        "Authorization": f"Basic {CREDENTIAL_B64}",
        "Content-Type": "application/x-www-form-urlencoded",
    }
    data = {
        "grant_type": "client_credentials",
        "scope": "https://myresourceserver1.com/marketplace"
    }
    response = requests.post(
        "https://oauth.totogi.io/oauth2/token",
        headers=headers,
        data=data
    )
    token = response.json()["access_token"]
    return token

5. This token will be needed to make any GraphQL calls.

GraphQL Calls

POST any GraphQL queries or mutations to the API endpoint displayed on the right --> Include an Authorization header with the value containing the access token retrieved in the prior step. For example, assume your GraphQL query or mutation is stored in graphql.query.txt and your token value is mytoken123asd. Then, you can use the curl command from the CLI as follows:

curl -X POST https://api.totogi.io/graphql -H "Authorization: mytoken123asd" -d @graphql.query.txt

You can also use your programming language of choice to make requests. Here's an example with Python.

Production Server:
https://marketplace.totogi.com/graphql