Използвайте бранд за съобщения, който принадлежи на акаунта
Използвайте активиран 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 може да означава, че регистърът е приел операцията, но локалното трайно съхраняване или таксуването е било неуспешно. Запазете идентификатора на заявката, прегледайте текущите записи и изяснете несъответствията с поддръжката, преди да използвате нов ключ. Не приемайте, че грешката означава липса на поръчка.