API Documentation

Learn how to connect and integrate with our API.

 

Authentication

All the API requests require authentication through an API key sent via the Authorization header as shown below.

Authorization: Bearer {api_key}
curl --request GET \
--url 'https://toradi.skystudios.co.tz/api/{endpoint}' \
--header 'Authorization: Bearer {api_key}' \

Errors

Our API uses conventional HTTP status codes to indicate the success or failure of a request.

{
    "errors": [
        {
            "title": "You do not have access to the API.",
            "status": 401
        }
    ]
}
200 Request completed successfully
400 Bad request - Required parameters are missing or invalid
401 Unauthorized - API key is missing or invalid
404 The requested resource was not found
429 Too many requests - Rate limit exceeded
500 Internal server error - this means there is a problem on our end
All API endpoint results work with the UTC timezone unless specified otherwise.
User
Links
Links statistics
Pixels
Splash pages
QR codes
Data
Notification handlers
Custom domains
Account logs