PROTOCOL SPECIFICATION
Детерминированный программный интерфейс для M2M-интеграции. Асинхронная нормализация данных, идемпотентные запросы и поддержка ГОСТ TLS.
[ АВТОРИЗАЦИЯ ]
API использует Bearer токены. Для суверенных инсталляций обязательна настройка двухстороннего mTLS с ГОСТ Р 34.10-2012.
ТОЧКИ ПОДКЛЮЧЕНИЯ (BASE URLS)
Public: https://api.ru.autonomouscore.net/v1
Sovereign: https://sovereign.ru.autonomouscore.net/v1
On-Prem: https://api.internal.local/v1
Идемпотентность: передайте заголовок X-Idempotency-Key для безопасных повторных запросов в случае обрыва соединения.
Инициализирует асинхронный пайплайн санации. Загружает сырой файл (CSV, XLSX) в изолированный контур. Возвращает task_id для последующего опроса.
ПАРАМЕТРЫ ЗАПРОСА (MULTIPART/FORM-DATA)
file*binaryФайл с ненормализованной номенклатурой (CSV, XLSX). Ограничение: 50MB.
webhook_urlstringURL для POST-уведомления по завершении обработки (опционально).
target_schemastringФормат выхода. По умолчанию CommerceML_2.1.
Возвращает актуальный статус выполнения задачи по ее идентификатору.
Отдаёт сгенерированный CommerceML XML-манифест для импорта в учетные системы (1С:Предприятие, МойСклад). Возвращается с заголовком Content-Type: application/xml.
[ ОШИБКИ И ЛИМИТЫ ]
400Bad Request
Невалидный формат файла или отсутствуют обязательные параметры.
401Unauthorized
Невалидный, просроченный или отозванный Bearer-токен.
429Too Many Requests
Превышен лимит запросов (Rate Limit). Смотрите заголовки X-RateLimit.
451Unavailable For Legal Reasons
Блокировка по 152-ФЗ (запрет трансграничной передачи ПДн).
500Internal Server Error
Системный сбой пайплайна. Повторите запрос с тем же Idempotency-Key.