Лимиты, списания и повтор отправки
Перед загрузкой получите GET /limits с ключом организации. Лимиты могут различаться. Проверяйте файлы по лимитам своего подключения. Не берите ограничения из учебных примеров.
| Поле /limits | Единица и смысл |
|---|---|
| max_files | Число документов после распаковки архивов. |
| max_file_bytes | Размер одного файла в байтах. |
| max_total_bytes | Суммарный размер комплекта в байтах. |
| max_pages | Число страниц комплекта. Сервер определяет его после подготовки документов. |
| oversize_factor | 1 запрещает превышение основного лимита. 2 разрешает двойной объём. Сервер учитывает этот объём при списании проверок. |
Ноль в отдельном лимите означает, что профиль не ограничивает этот показатель. Входной сервер и распаковка имеют свои технические ограничения. Входной сервер может вернуть 413 с HTML. Перед разбором ответа проверьте Content-Type.
volume_units показывает учтённый объём: 0, 1 или 2. Значение зависит от результата и условий подключения. checks_left показывает число оставшихся проверок. Это не сумма в рублях. Если status равен failed, проверьте refunded.
Условия доступа определяются тарифом организации.
| Ситуация с Idempotency-Key | Результат и действие |
|---|---|
| Ответ на загрузку потерялся | Повторите те же файлы и параметры с тем же ключом. Новый ключ может создать новую проверку. |
| Тот же ключ и тот же запрос | Сервер возвращает 200 с прежним run_id. Вторую проверку он не создаёт. |
| Тот же ключ, но изменены файлы, kinds, адрес, задание или bundle_id | Сервер возвращает 409 idempotency_conflict. Для новой версии комплекта используйте новую метку. |
| Первая отправка ещё не завершена | 409 idempotency_pending. Подождите и повторите с прежней меткой. |
Сервер сравнивает содержимое файлов, а не только имена и размеры. Метка действует в пределах организации. Для исправленного комплекта используйте новый Idempotency-Key. Запросы GET не требуют этой метки.
Срок хранения исходных документов зависит от подключения. DELETE /runs/{run_id}/documents удаляет исходные документы и производные файлы. Опубликованный отчёт и история остаются. Удаляйте документы только после done или failed. Для текущей проверки серверу нужны исходные файлы.