Ошибки и коды

UI и API ошибки с примерами и понятными действиями пользователя.

UI-ошибки в приложении

Чаще всего в интерфейсе встречаются понятные уведомления о следующих ситуациях:

Превышен лимит участников — достигнуто максимальное количество пользователей в организации.
Превышен лимит строк — организация достигла лимита записей.
Превышен лимит данных таблиц — закончился объём для значений ячеек, JSON, длинных текстов и настроек таблиц.
Превышен лимит хранилища — закончилось место для файлов.
Превышен лимит запросов API — исчерпан месячный лимит Public API.
Превышен лимит переноса данных — достигнут дневной лимит на импорт/экспорт.
Нельзя передать права самому себе — для передачи владельца выберите другого участника.
Нельзя передать права в единственной организации — сначала создайте или получите доступ к другой организации.
Неверный/просроченный код передачи прав — запросите новый код подтверждения и повторите операцию.
Слишком много запросов — система временно ограничивает частые однотипные действия.

Что делать:

открыть Статистика и Тариф;
уменьшить объём операции;
сократить большие значения или JSON;
повторить позже или использовать фоновые операции;
при необходимости обратиться в поддержку через виджет в правом нижнем углу экрана.

HTTP-коды Public API

200 OK — успешно выполнен GET, PATCH или DELETE запрос.
201 Created — успешно создана запись через POST; ответ содержит заголовок Location.
400 — ошибка параметров (where, row_id, тело запроса).
401 — отсутствует/некорректен токен.
403 — недостаточно прав (например, запись токеном с правами только на чтение).
404 — не найдены таблица/запись/токен.
429 — превышен лимит запросов.
500 — внутренняя ошибка сервера (если ошибка повторяется, обратитесь в поддержку через виджет в углу экрана).

Примеры ошибок и действия

Примеры:

{"message":"api_token_not_found"} → проверьте токен.
{"message":"public_unauthorized"} → отсутствует или недействителен токен.
{"message":"public_read_only"} → используйте токен с правами на запись.
{"message":"api_request_limit_exceeded"} → превышен месячный лимит API-запросов.
{"message":"public_invalid_where"} → проверьте синтаксис параметра where.
{"message":"row_limit_exceeded"} → превышен лимит записей организации.
{"message":"tabular_data_limit_exceeded"} → не хватает лимита Данные таблиц; сократите значения, удалите лишние данные или увеличьте лимит.
{"message":"storage_limit_exceeded"} → закончилось место в файловом хранилище.
{"message":"request_entity_too_large"} → тело запроса слишком большое; отправьте меньше данных за один раз.
{"message":"public_invalid_data"} → данные не прошли проверку размера или формата значений.
{"message":"validation_error"} → проверьте типы полей и размер значений в data.
{"message":"row_not_found"} → проверьте row_id и фильтр таблицы.

Быстрый алгоритм:

Сверьте код статуса.
Проверьте message и текст ошибки.
Для лимитов откройте Статистика.
Сократите payload, исправьте значение и повторите запрос.

Куда смотреть в интерфейсе

В режиме API используйте панель результата: статус, заголовки, тело ответа.
Для лимитов откройте вкладку Статистика организации, а условия тарифа — вкладку Тариф.
Для сценариев импорта/экспорта смотрите Импорт и экспорт.