Ліміти та помилки

Ваш тариф

Кожен документ, який читає Ocost, один раз зараховується до місяця вашої компанії. Повторно надіслані байти і пошуки не зараховуються. Налаштування › Тариф і оплата показує місяць дотепер. Кожна відповідь на POST /public/v1/files каже в X-Ocost-Documents-Left, скільки залишилося.

На ліміті Ocost усе одно зберігає файл. Він відповідає not_read з reason: "limit" і renews_on. Ocost сам прочитає файл, щойно почнеться новий місяць або тариф зросте.

Обмеження частоти

Кожен ключ має ліміт на хвилину для кожного дозволу:

ДозвілВикликів на хвилину
documents:write120
documents:read600
search:read60
figures:read120
exports:write10

Понад ліміт Ocost відповідає 429 urn:ocost:key:rate з Retry-After у секундах. З однієї адреси 30 неправильних ключів за хвилину отримують 401, а більше — 429.

Усі ключі з однієї адреси ділять зовнішній ліміт: 50 запитів на секунду, сплески до 200 і 100 відкритих одночасно. Понад нього приходить 429 простим текстом із Retry-After. Надсилайте лише кілька запитів одночасно і розподіляйте пакет на всю його хвилину.

Розміри

ЩоЛіміт
Файл25 МБ, відхиляється ще до читання з 413 urn:ocost:file:too_large
Довгий PDFЧитаються лише його перші сторінки. pages_read каже, скільки.
Пошукq до 200 символів, limit до 50, offset до 250
Запит MCP4 МБ. Ключі з documents:write можуть надсилати base64 файлу. Понад це — 413.

Помилки

Помилки — це problems за RFC 9457 з Content-Type: application/problem+json. Розгалужуйте за status і type. detail написано англійською для ваших журналів, і він може змінитися.

JSON
{
  "type": "urn:ocost:key:scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "This key lacks the scope documents:write.",
  "instance": "/public/v1/files"
}
ТипСтатусЗміст
urn:ocost:key:invalid401Немає ключа, або він неправильний, відкликаний чи прострочений.
urn:ocost:key:scope403Ключу бракує дозволу.
urn:ocost:key:rate429Забагато викликів. Зачекайте Retry-After.
urn:ocost:file:too_large413Файл більший за 25 МБ.
urn:ocost:file:format415Формат, який Ocost не читає.
urn:ocost:file:reading409Файл саме читається. Видаліть його пізніше.
urn:ocost:file:kept409Ті самі байти зберігаються там, де ключі їх не бачать, наприклад в особистому завантаженні людини. Нічого не змінюється.
urn:ocost:file:linked409Файл ще потрібен Ocost. Видаліть його в Ocost, коли він більше нічому не потрібен.
about:blank404Немає такого файлу чи документа, або він належить іншій компанії.
about:blank422Неправильні поля, кожне в errors[] зі своїм loc.
about:blank503Спробуйте ще раз трохи згодом.

Файл, надісланий без заголовка Content-Length, отримує 411.

Повторні спроби

ВідповідьЩо робити
429, 5xxЗачекайте Retry-After або робіть паузи 1, 2, 4 секунди і так далі, щонайбільше хвилину.
401Зупиніться і повідомте людину. Ключ треба замінити.
Будь-який інший 4xxНе надсилайте той самий запит знову.

Повторне надсилання файлу безпечне, бо ті самі байти — це той самий файл. Повторне видалення теж безпечне і відповідає 404.

Ваші дані

Ocost працює в ЄС. Оригінали, прочитане і пошуковий індекс зберігаються, доки ви не видалите файл або доки не буде видалено вашу компанію. Документи ніколи не навчають модель.

Див. також