Ошибки и rate limits
HTTP-коды, которые возвращает Memo AI API, их причины и как обрабатывать rate limits.
API использует стандартные HTTP-коды. 2xx — успех; 4xx — что-то в запросе нужно исправить.
Коды статусов
| Статус | Значение | Типичная причина |
|---|---|---|
200 | OK | Запрос успешен. |
201 | Created | Ключ создан (управление). |
204 | No Content | Ключ отозван (управление). |
401 | Unauthorized | Нет/неверный/истёкший ключ или ключ передан в URL. |
403 | Forbidden | План без доступа к API (api_access_denied). |
404 | Not Found | Ресурс не существует в вашем workspace. |
422 | Unprocessable Entity | Неверный параметр (например, плохой format, слишком много ids). |
429 | Too Many Requests | Превышен rate limit. |
5xx | Ошибка сервера | Временная — повторите с backoff. |
Формат ошибки
Большинство ошибок возвращают JSON с полем detail. Ошибки доступа/плана включают машиночитаемый
code:
{
"detail": {
"code": "api_access_denied",
"message": "Your current plan does not include API access. Please upgrade to a plan with API & MCP support."
}
}{
"detail": "Invalid API key"
}Частые случаи
| Что видите | Почему | Как исправить |
|---|---|---|
401 на каждом вызове | Ключ отозван, истёк или с пробелом в конце | Создайте новый ключ, аккуратно скопируйте |
401 с ключом в query-строке | Ключи в URL отклоняются намеренно | Перенесите ключ в заголовок Authorization |
403 api_access_denied | План без API & MCP | Перейдите на Pro или Expert |
404 на известном ID | Расшифровка в другом workspace | Используйте ключ того workspace |
422 на экспорте | format не md/txt или ids пуст/больше 100 | Исправьте параметр |
Rate limits
Лимиты — на ключ:
| Поверхность | Лимит |
|---|---|
| Data-эндпоинты (list / get / export / bulk) | 500 запросов / минуту |
| Управление ключами | 180 запросов / минуту |
При превышении приходит 429. Обрабатывайте аккуратно:
- Сделайте паузу, не повторяйте сразу. Подождите несколько секунд и попробуйте снова.
- Избегайте плотных циклов. Для экспорта многих расшифровок используйте Массовый экспорт (один запрос) вместо цикла по одиночным экспортам.
- Распределяйте нагрузку вместо сотен вызовов разом.
Не делайте мгновенный авто-ретрай на 429
Немедленные авто-повторы только усугубляют лимит. Используйте экспоненциальный backoff (например, 1s, 2s, 4s).