Внутреннее API Felmee (0.0.14)
Все REST-эндпоинты возвращают ответ в едином формате:
"success": false,
"message": "...",
"codeError": null,
"error_code": null,
"data": {} }Где:
success- флаг успешного выполнения запросаmessage- человекочитаемое описание результатаcodeError- legacy-alias поляerror_code; при ошибке содержит тот же код, при успехеnullerror_code- машинный код ошибки; для успешных ответов всегдаnulldata- полезная нагрузка; может быть объектом, массивом илиnull
Перед привязкой загруженных файлов к сообщениям, услугам, профилям, категориям, блогам, отзывам, жалобам, обращениям и документам регистрации требуется UPLOADED. PENDING, FAILED и отсутствующие файлы не принимаются. Проверки владельца, доступа, назначения и типа файла сохраняются. Это относится и к замене вложений. Успешный ответ POST /api/file/upload гарантирует полную подготовку и локальную запись файла, включая предусмотренные оригинал и preview. Полученный file_id можно сразу прикреплять. Обычные сообщения REST/WS с неготовыми файлами отклоняются с file_not_ready (REST: HTTP 409). Остальные операции сохраняют существующие ошибки валидации. Создание услуги сохраняет ожидание готовности до 5 секунд и ошибки file_upload_failed / file_upload_timeout.
invalid_body- тело запроса не прошло валидацию или нарушает бизнес-правилаunauthorized- отсутствует или невалиден JWT / refresh tokennot_found- ресурс не найденslot_unavailable- выбранное время записи больше недоступно (в том числеPOST /api/record/create/approve/{id}возвращает HTTP 409)conflict- запрос корректен по форме, но конфликтует с текущим состоянием ресурсаBUSINESS_INACTIVE- при выводе статус бенефициара по ИНН подтверждён как неактивныйINSUFFICIENT_FUNDS- недостаточно доступных средств для выводаREQUISITES_REQUIRED- для вывода нет сохранённых реквизитовIDEMPOTENCY_KEY_REUSED- ключ повторно использован с другим телом запросаREGISTRY_UNAVAILABLE- актуальный статус по ИНН временно не удалось проверитьBENEFICIARY_NOT_READY- нет единственного подтверждённого бенефициараBANK_ACCOUNT_UNAVAILABLE- стандартный виртуальный счёт отсутствуетBANK_UNAVAILABLE- интеграция с банком временно недоступнаobject_modified_by_another_thread- объект был изменён другой параллельной операцией; клиент должен перечитать актуальное состояние и повторить запросmember_deletion_already_scheduled- удаление участника салона уже запланированоmember_deletion_blocked- удаление участника салона заблокировано текущим состояниемmember_already_active- участник салона уже активенmember_restore_window_expired- срок восстановления участника салона истёкmember_reactivation_not_allowed- повторная активация участника салона запрещенаaction_too_late- действие запрещено по бизнес-правилу минимального времени до начала событияtoo_many_request- превышен лимит запросовcode_is_gone- одноразовый код истёк или больше не действителенforbidden- у пользователя нет доступа к ресурсуuser_blocked- пользователь заблокированsalon_permission_denied- у участника салона нет permission для запрошенного endpointgeocoding_failed- адрес услуги или мастера передан, но backend не смог получить для него координатыfile_not_ready- вложения сообщения ещё загружаются, загрузились с ошибкой или больше не существуют; сообщение не созданоconflicting_geo_filters- одновременно переданы несовместимые географические фильтрыaddress_suggestions_failed- backend не смог получить подсказки адресов от внешнего сервисаinvalid_captcha- captcha отсутствует, невалидна или не прошла проверкуinvite_code_not_found- код приглашения не найденadmin_account_not_found- учётная запись администратора не найденаrecord_not_found- запись не найденаrecord_not_cancelable- запись нельзя отменить в текущем состоянииfeed_expired- срок действия выдачи рекомендаций истёкfeed_busy- выдача рекомендаций временно занята другим запросомfile_upload_failed- upload не завершил подготовку или запись файла (HTTP 500); для создания услуги сохраняется HTTP 422 при FAILEDfile_upload_timeout- создание услуги не дождалось готовности ранее загруженных фото за 5 секунд (HTTP 408)internal_error- внутренняя ошибка сервера