Користите бренд за размену порука који припада налогу
Користите омогућен 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 може значити да је регистар прихватио операцију, али да локално трајно чување или наплата нису успели. Сачувајте идентификатор захтева, прегледајте тренутне записе и разрешите неслагања са подршком пре употребе новог кључа. Не претпостављајте да грешка значи да наруџбина не постоји.