Используйте бренд для обмена сообщениями, принадлежащий учётной записи
Используйте активированную учётную запись API для доступа по HTTPS с разрешённого исходного IP-адреса. Поддерживается аутентификация Basic и Bearer. Идентификатор бренда должен принадлежать этой учётной записи. Сохраняйте конфиденциальность токенов поставщика, идентификационных данных бренда и полученных отчётов.
Закажите новую внешнюю проверку
Используйте POST, если поставщик должен выполнить новую проверку этого бренда. Если у вас уже есть результат поставщика, используйте импорт вместо нового заказа. Это отдельная операция, не связанная с такой процедурой, как повторная проверка идентификационных данных бренда.
Сначала получите текущие данные бренда и подтвердите его идентификационные сведения. Выберите поддерживаемую комбинацию поставщика и класса в разделе «актуальные каталоги» и изучите требования этого поставщика. Не каждый поставщик поддерживает все классы. Дополнительные сведения для политической проверки должны описывать реальную организацию или кампанию, а не содержать демонстрационные данные.
Подготовьте запрос поставщику
| Поле | Значение |
|---|---|
| evpId | Обязательный идентификатор поставщика из актуального каталога поставщиков внешней проверки, длиной 1–10 символов. |
| vettingClass | Поддерживаемый класс проверки, который вы намерены приобрести; выберите его явно и подтвердите стоимость. |
| additionalRequestPayload | Строка в формате JSON со сведениями, зависящими от поставщика; обязательна для политической проверки. Это строка внутри внешнего объекта JSON, а не вложенный объект. Уточните все необходимые сведения у выбранного поставщика. |
Подтвердите плату при успешном и неуспешном исходе
Текущие розничные тарифы в долларах США, полученные 24 октября 2026 года. Подтвердите актуальную сумму перед размещением реального заказа. Достаточность предоплаченных средств проверяется по цене успешного исхода; возможность покупок должна быть включена.
| Класс | Активный результат | Неуспешный результат |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL с запросом Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Для ожидающих завершения заказов сохраняются суммы для успешного и неуспешного исхода; расчёт выполняется при синхронизации результата ACTIVE или FAILED. Для последних двух классов настроена одинаковая плата при любом из этих окончательных исходов. Если окончательный результат получен сразу, плата может быть списана при формировании ответа на заказ. Последующая синхронизация статуса может привести к списанию ожидающей оплаты суммы.
Не считайте mock:true гарантией бесплатной внешней проверки. Текущий механизм расчётов за внешнюю проверку всё равно может зарегистрировать этот заказ и списать за него плату. Эти инструкции не требуют реальной покупки для тестирования; используйте автономные тестовые данные, пока не будете готовы разрешить платную проверку.
Отправьте один предварительно проверенный заказ
Подготовьте vetting-order.json с идентификатором поставщика, классом и всей необходимой дополнительной информацией. Файл содержит фактический запрос, который вы намерены отправить. Сохраняйте его конфиденциальность.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Отслеживайте фактический исход
Успешный ответ HTTP может содержать запись о ещё не завершённой проверке. Сохраните её vettingId и проверьте vettingStatus, причины, оценку и даты начала и окончания действия, если они доступны. PENDING и UNSCORE требуют дальнейшего отслеживания; ACTIVE, FAILED и EXPIRED обозначают разные исходы. Само по себе принятие запроса на уровне HTTP не подтверждает благоприятную оценку или соответствие условиям допуска кампании.
Используйте статус внешней проверки для отслеживания записи. Получение или импорт окончательного результата может привести к расчёту по ранее размещённому платному заказу; это не обязательно исключает списание уже ожидающей оплаты суммы.
Повторно отправляйте тот же запланированный запрос
Используйте один Idempotency-Key для каждой запланированной операции и сохраняйте без изменений метод, путь, строку запроса и байты тела. Ключи допускают 1–128 печатных символов ASCII без пробелов. Повторный запрос для ещё выполняющейся операции может вернуть 409 с Retry-After. Для завершённых запросов повторно возвращается сохранённый ответ, включая ошибки. Соблюдайте ограничения частоты запросов.
После сбоя передачи данных может возвращаться кэшированный ответ 502. Кэшированный ответ 500 с requestId может означать, что реестр принял операцию, но произошёл сбой локального сохранения данных или выставления платы. Сохраните идентификатор запроса, проверьте текущие записи и согласуйте состояние операции со службой поддержки, прежде чем использовать новый ключ. Не считайте, что ошибка означает отсутствие заказа.