Справочник API

Полное описание endpoint для работы с датасетами.

Base URL

https://workbench.ab-labz.com/api/v1

POST /datasets/upload/

Загружает датасет эксперимента с валидацией на лету.

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

Authorization: Bearer abn_xxxxxxxxxxxxxxxxxxxxx

Request

URL:

POST /api/v1/datasets/upload/?experiment_id={id}

Query Parameters:

Параметр	Тип	Обязательный	Описание
experiment_id	string	Да	ID эксперимента. Макс 128 символов, только A-Za-z0-9._-

Headers:

Authorization: Bearer abn_xxxxxxxxxxxxxxxxxxxxx
Content-Type: text/csv

Body:

Raw CSV файл (binary data). Используйте --data-binary в cURL или data=file_object в requests.

Важно: Файл отправляется как raw body, НЕ как multipart/form-data!

Response 201 Created

{
  "success": true,
  "size_mb": 45.32,
  "experiment_id": "homepage_test",
  "message": "Датасет успешно загружен"
}

Поля:

Поле	Тип	Описание
success	boolean	Статус загрузки (всегда true при 201)
size_mb	float	Размер загруженного файла в мегабайтах
experiment_id	string	ID эксперимента из запроса
message	string	Сообщение об успешной загрузке

Ошибки

Код	Описание	Решение
400	Невалидный experiment_id	Используйте только A-Za-z0-9._-, макс 128 символов
400	Обнаружен архив (ZIP, GZIP, RAR, 7z)	Загружайте CSV без архивирования
400	Файл не похож на CSV	Проверьте структуру файла и кодировку UTF-8
401	Неверный API ключ	Проверьте формат: Bearer abn_...
403	Организация деактивирована	Свяжитесь с администратором
413	Файл слишком большой (>200 МБ)	Уменьшите размер датасета или разделите на части
500	Ошибка хранилища	Повторите запрос через несколько секунд