Skip to content

Authentication

An API Key is required to be sent as a part of every request.

Key Components

  • Site ID: Your unique site identifier.
  • API Key: Access credential.
  • Secret Key: Used for request signatures.

Basic Authentication Method

Credential Composition

  • Username: site_id
  • Password: x-api-key
  • Encoding: Base64

Example:

json
  "site_id": "123456",
  "x-api-key": "abcdef"

1. Base64 Encoding

  1. Combine the site_id and x-api-key with a colon (:) separator: 123456:abcdef.
  2. Base64 Encode: MTIzNDU2OmFiY2RlZg==.

2. Authorization Header

http
Authorization: Basic MTIzNDU2OmFiY2RlZg==

This header will be sent with your request, and the server will decode the Base64 string to retrieve the site_id and x-api-key and authenticate your request.

Troubleshooting Authentication

Common Issues

Error CodeDescriptionRecommended Action
401UnauthorizedVerify credentials
403ForbiddenCheck permission levels
429Rate LimitedImplement exponential backoff

For further assistance, contact our support team at [email protected].