Authentication

This page details how to get an API Key as well as how to authenticate requests.

API Key

In order to get an API key you must create an API account on our website. After successfully creating an account, you can request an activation of a trial or purchase a credit/subscription package in order to start making requests.

Trial activations are subject to advanced screening in order to prevent abuse.

Authenticating Requests

Toto API uses the 'x-api-key' custom header convention to authenticate requests. To authenticate a request, provide the API Key in the x-api-key header of the request as shown below:

Curl

curl -X POST \
  "<url>" \
  -H "accept: application/json" \
  -H "x-api-key: <api_key>" \
  -H "Content-Type: application/json" \
  -d <json_payload>'

Python

import requests

url="https://toto.oz.xyz/api/metadata/get_past_usernames"

headers={
    'accept': 'application/json',
    'x-api-key': api_key,
    'Content-Type': 'application/json',
}

example_payload={
    'user': username,
    'how': 'username',
    'page': 1,
}

response = requests.post(url=url, headers=headers, json=example_payload)