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

API использует Bearer токен (API ключ) для авторизации всех запросов.

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

Перейдите в Информация → API ключи.

Доступ: Только администраторы организации могут создавать и управлять API ключами.

Шаги создания:

1. Нажмите "Создать ключ"
2. Введите название (например, "Production ETL", "Daily Export")
3. Скопируйте сгенерированный ключ

Важно: Ключ показывается только один раз! Сохраните его в безопасном месте.

Формат ключа

API ключи имеют префикс abn_:

abn_xxxxxxxxxxxxxxxxxxxxx

Использование в запросах

Добавьте ключ в заголовок Authorization с префиксом Bearer:

Authorization: Bearer abn_xxxxxxxxxxxxxxxxxxxxx

Пример с cURL

curl -X POST "https://workbench.ab-labz.com/api/v1/datasets/upload/?experiment_id=test_exp" \
  -H "Authorization: Bearer abn_xxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: text/csv" \
  --data-binary @dataset.csv

Пример с Python

import requests

API_KEY = 'abn_xxxxxxxxxxxxxxxxxxxxx'
API_URL = 'https://workbench.ab-labz.com/api/v1'

with open('dataset.csv', 'rb') as f:
    response = requests.post(
        f'{API_URL}/datasets/upload/',
        params={'experiment_id': 'test_exp'},
        headers={
            'Authorization': f'Bearer {API_KEY}',
            'Content-Type': 'text/csv'
        },
        data=f
    )

Управление ключами

У каждой организации есть один API ключ. Администраторы организации могут управлять им в разделе Информация → API ключи.

Регенерация ключа

Если ключ скомпрометирован или утерян:

1. Перейдите в Информация → API ключи
2. Нажмите "Регенерировать ключ"
3. Старый ключ будет удалён, создастся новый
4. Скопируйте новый ключ (показывается только один раз)

Важно: После регенерации старый ключ перестаёт работать немедленно. Обновите ключ во всех интеграциях.

Ошибки авторизации

401 Unauthorized

Возможные причины:

• Ключ неверный или отозван
• Неправильный формат заголовка (отсутствует префикс Bearer)
• Ключ не передан в заголовке

Решение:

1. Проверьте формат заголовка: Authorization: Bearer abn_...
2. Убедитесь, что ключ активен в разделе Информация → API ключи
3. Проверьте отсутствие лишних пробелов или символов
4. Убедитесь, что используете актуальный ключ (не истёкший)

Пример правильного формата:

# Правильно
headers = {'Authorization': f'Bearer {API_KEY}'}

# Неправильно - нет префикса Bearer
headers = {'Authorization': API_KEY}

# Неправильно - неверное название заголовка
headers = {'auth': f'Bearer {API_KEY}'}

403 Forbidden

Причина: Организация деактивирована или отсутствует активная подписка

Решение: Свяжитесь с администратором организации