Списание лимита и идемпотентность

Сколько единиц спишется, как избежать двойного списания при повторах.

Сколько списывается#

Списывается по одной единице за каждый распознанный документ. Если на изображении найдено три документа — три единицы; если ни одного — ноль.

Перед обращением к сервису распознавания проверяется остаток: при нулевом остатке запрос завершится ошибкой 402 и картинка обрабатываться не будет.

Идемпотентность#

Повторная отправка запроса при сетевой ошибке не должна списывать лимит дважды. Для этого передайте собственный идентификатор операции — в поле transactionId или в заголовке x-idempotency-key. Повтор с тем же значением не спишет лимит второй раз.

Повтор с тем же ключом

curl -X POST https://devmoon.ru/api/v1/recognize \
  -H "Authorization: Bearer dm_ВАШ_КЛЮЧ" \
  -H "x-idempotency-key: order-4821-page-1" \
  -F "file=@passport.jpg"

Когда лимит закончился#

Запрос вернёт 402 с сообщением о нехватке лимита. Пополнить его можно двумя способами: докупить пакет или дождаться следующего периода лицензии. Подробнее — в разделе Тарифы, лимиты и пакеты.