Аутентификация

API-ключи

Для доступа к API используются ключи формата ak_.... Ключ передаётся в заголовке каждого запроса:

Authorization: Bearer ak_aBcDeFgHiJkLmNoPqRsTuVwXyZ...

Создание ключа

1. Откройте личный кабинет  на сайте Aidentika
2. Перейдите на вкладку API
3. Нажмите «Создать ключ»
4. Укажите название
5. Скопируйте и сохраните ключ

Ключ доступен для копирования в кабинете. Рекомендуем сохранить его в безопасном месте сразу после создания. Максимум 10 ключей на аккаунт.

Отозвать ключ можно там же — в настройках API в личном кабинете. После отзыва ключ перестаёт работать немедленно.

Rate Limiting

Каждый API-ключ ограничен по количеству запросов в минуту (по умолчанию 100).

Заголовки ответа

Каждый ответ содержит информацию о лимите:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1772000000

Превышение лимита

При превышении лимита возвращается 429 Too Many Requests:

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Limit: 100 requests/minute.",
  "details": {
    "limit": 100,
    "reset_at": 1772000000
  }
}

Дополнительный заголовок Retry-After указывает сколько секунд ждать.

Если вам нужен более высокий лимит — свяжитесь с поддержкой: @aidentika_support_bot .

Пример подключения

import requests
 
API_KEY = "ak_ваш_ключ"
BASE_URL = "https://api.aidentika.com/api/v1/public"
 
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}
 
# Проверить баланс
resp = requests.get(f"{BASE_URL}/balance", headers=headers)
print(resp.json())
# {"balance": 100, "available": 96, "holds": 4}

const API_KEY = "ak_ваш_ключ";
const BASE_URL = "https://api.aidentika.com/api/v1/public";
 
const headers = {
  Authorization: `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};
 
// Проверить баланс
const resp = await fetch(`${BASE_URL}/balance`, { headers });
const data = await resp.json();
console.log(data);
// {"balance": 100, "available": 96, "holds": 4}

# Проверить баланс
curl https://api.aidentika.com/api/v1/public/balance \
  -H "Authorization: Bearer ak_ваш_ключ"
# {"balance": 100, "available": 96, "holds": 4}

Безопасность

• Не храните ключи в коде — используйте переменные окружения
• Не передавайте ключи в URL (только в заголовке Authorization)
• Отзовите ключ немедленно, если он был скомпрометирован (через ЛК → API)
• Создавайте отдельные ключи для разных приложений