Заявка на добавление провайдера
POST /v1/provider/apply
/v1/provider/applyМетод подачи заявки для расширения справочника provider_id. Сразу после заявки статус PENDING. Пока статус не ACTIVE, этот код нельзя передавать в локацию и в полигон: location/create и polygon/create отвечают STOREFRONT_RULE_VIOLATION.
scope = OWN — провайдер для своего кабинета, другие кабинеты запись не видят. scope = SHARED — заявка в общий справочник, после ACTIVE код видят все кабинеты, owner остаётся MERCHANT.
Повтор того же кода этим кабинетом возвращает существующую заявку.
Тело запроса
Код провайдера. Латиница в верхнем регистре, цифры и _. Начинается с буквы. Длина от 2 до 32. Мерчант передаёт одну и ту же строку на каждую витрину.
Имя на карте, до 64 символов.
Область видимости.
SHARED: общий справочник, запись видят все кабинеты.
OWN: мерчант завёл провайдера для своего кабинета, другие кабинеты эту запись не видят.
Ссылка на логотип.
На каком основании мерчант использует это имя. Можно не передавать.
Успешный ответ
200A successful response. application/json
Номер заявки (только при успехе). По нему заявку можно отфильтровать в POST /v1/provider/application/list. Повтор того же кода этим кабинетом возвращает тот же номер.
Тот же код, который мерчант передал в запросе. Всегда присутствует (успех и ошибка); пустая строка, если provider_id не был передан.
Имя из заявки (только при успехе).
Та же ссылка, которую мерчант передал в запросе (только при успехе).
На каком основании мерчант использует это имя (при успехе, если было передано в заявке).
Область видимости (только при успехе).
SHARED: общий справочникOWN: только кабинет, который создал запись
Для заявки мерчанта MERCHANT (только при успехе).
CATALOG: запись общего справочника
Статус заявки (только при успехе).
PENDING: ждёт модерацииACTIVE: одобренREJECTED: отклонён
Дата и время создания заявки (date-time, RFC3339, только при успехе). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00).
Дата и время последнего обновления заявки (date-time, RFC3339, только при успехе). Формат RFC3339 с обязательным timezone (пример: 2026-07-02T10:25:00+02:00).
Структурированные ошибки по полям (только при неуспехе). Коды только из ProviderApplyValidationErrorCode.
При ошибке возвращаются только provider_id + errors; поля заявки не передаются.
Ошибка валидации или бизнес-правила поля заявки. Для правила витрины: code=STOREFRONT_RULE_VIOLATION.
Ошибка валидации или бизнес-правила поля заявки. Для правила витрины: code=STOREFRONT_RULE_VIOLATION.
Показать свойстваСкрыть свойства
Путь к полю: provider_id, name, scope, logo_url, rights_basis.
Код ошибки.
REQUIRED: не переданы provider_id, name, scope или logo_url.
INVALID_TYPE: неверный JSON-тип.
INVALID_FORMAT: provider_id пустой, с пробелом, кириллицей или дефисом, либо короче 2 или длиннее 32 символов.
INVALID_ENUM: provider_id совпал с постоянным кодом справочника либо scope не из SHARED и OWN.
STOREFRONT_RULE_VIOLATION: scope=SHARED, и этот код уже есть в общем справочнике у другого кабинета.
Текст для клиента. Для STOREFRONT_RULE_VIOLATION — описание правила.
Ошибки
400Некорректный запрос application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
401Ошибка авторизации application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
429Превышен лимит запросов application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.
500Внутренняя ошибка сервера application/json
Класс транспортной ошибки запроса (HTTP 4xx/5xx).
Поэлементные и бизнес-ошибки сущности приходят в HTTP 200 в errors/failed, не в этом поле.
ERROR_TYPE_UNSPECIFIED: не используетсяERROR_TYPE_UNAUTHORIZED: HTTP 401ERROR_TYPE_RATE_LIMIT: HTTP 429ERROR_TYPE_INTERNAL: HTTP 500ERROR_TYPE_BAD_REQUEST: HTTP 400 (уровень запроса)
Машинный код ошибки. Уточняет error_type.
Человекочитаемое сообщение об ошибке.