Zamów zewnętrzną weryfikację marki

Użyj marki do wysyłania wiadomości należącej do konta

Korzystaj z aktywnego konta API przez HTTPS z dozwolonego źródłowego adresu IP. Obsługiwane jest uwierzytelnianie Basic i Bearer. Identyfikator marki musi należeć do tego konta. Zachowaj poufność tokenów dostawcy, danych identyfikacyjnych marki i zwróconych raportów.

Zamów nową weryfikację zewnętrzną

Użyj POST, gdy dostawca ma przeprowadzić nową weryfikację tej marki. Jeśli masz już wynik od dostawcy, zamiast tego skorzystaj z funkcji importu. Jest to operacja odrębna od ponownej weryfikacji tożsamości marki.

Najpierw odczytaj aktualne dane marki i potwierdź jej dane identyfikacyjne. Wybierz obsługiwaną kombinację dostawcy i klasy z aktualnych katalogów i sprawdź wymagania tego dostawcy. Nie każdy dostawca obsługuje każdą klasę. Dodatkowe informacje do weryfikacji politycznej muszą opisywać rzeczywistą organizację lub kampanię, a nie zawierać przykładowe dane.

Przygotuj żądanie do dostawcy

Pola zamówienia zewnętrznej weryfikacji
Pole	Wartość
evpId	Wymagany identyfikator dostawcy z aktualnego katalogu dostawców zewnętrznej weryfikacji, 1–10 znaków.
vettingClass	Obsługiwana klasa, którą zamierzasz kupić; wybierz ją jawnie i potwierdź jej cenę.
additionalRequestPayload	Ciąg znaków zakodowany w formacie JSON, zawierający informacje właściwe dla dostawcy, wymagany przy weryfikacji politycznej. Jest to ciąg znaków wewnątrz zewnętrznego obiektu JSON, a nie obiekt zagnieżdżony. Potwierdź wszystkie wymagane informacje u wybranego dostawcy.

Potwierdź opłaty za powodzenie i niepowodzenie

Aktualne opłaty detaliczne w dolarach amerykańskich, odczytane 24 października 2026 r. Potwierdź aktualną kwotę przed złożeniem rzeczywistego zamówienia. Środki przedpłacone są sprawdzane względem ceny za pomyślny wynik; zakupy muszą być włączone.

Skonfigurowane opłaty za zewnętrzną weryfikację zależne od wyniku
Klasa	Wynik aktywny	Wynik nieudany
STANDARD	$46.12	$5.56
ENHANCED	$112.78	$6.67
POLITICAL	$73.34	$24.45
POLITICAL z żądaniem Express	$106.67	$24.45
AUTHPLUS	$13.89	$13.89
RCS	$83.34	$83.34

Oczekujące zamówienia zachowują kwoty za powodzenie i niepowodzenie, a ich rozliczenie następuje po synchronizacji wyniku ACTIVE lub FAILED. Dla dwóch ostatnich klas obowiązuje ta sama skonfigurowana opłata za oba wyniki końcowe. Jeśli wynik końcowy jest dostępny od razu, opłata może zostać naliczona podczas obsługi odpowiedzi na zamówienie. Późniejsza synchronizacja statusu może rozliczyć oczekującą opłatę.

Nie traktuj mock:true jako gwarancji bezpłatnej zewnętrznej weryfikacji. Obecny mechanizm rozliczania zewnętrznej weryfikacji nadal może zarejestrować to zamówienie i naliczyć za nie opłatę. Ta instrukcja nie wymaga rzeczywistego zakupu na potrzeby testów; korzystaj z danych testowych offline, dopóki nie zamierzasz autoryzować płatnej weryfikacji.

Wyślij jedno uprzednio sprawdzone zamówienie

Przygotuj plik vetting-order.json z identyfikatorem dostawcy, klasą i wszystkimi wymaganymi dodatkowymi informacjami. Plik zawiera rzeczywiste żądanie, które zamierzasz wysłać. Zachowaj jego poufność.

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"

Śledź rzeczywisty wynik

Pomyślna odpowiedź HTTP może zawierać rekord weryfikacji oczekującej na wynik. Zachowaj jego vettingId i sprawdź vettingStatus, uzasadnienia, ocenę punktową oraz daty rozpoczęcia i wygaśnięcia ważności, o ile są dostępne. PENDING i UNSCORE wymagają dalszego monitorowania; ACTIVE, FAILED i EXPIRED opisują różne wyniki. Samo przyjęcie na poziomie HTTP nie potwierdza korzystnej oceny punktowej ani kwalifikacji kampanii.

Użyj funkcji statusu zewnętrznej weryfikacji, aby śledzić rekord. Odczytanie lub zaimportowanie wyniku końcowego może rozliczyć wcześniejsze płatne zamówienie; nie musi być wolne od istniejącej, nierozliczonej opłaty.

Ponów to samo zamierzone żądanie

Używaj jednego Idempotency-Key na każdą zamierzoną operację i zachowaj dokładną metodę, ścieżkę, parametry zapytania oraz bajty treści żądania. Klucze obsługują 1–128 drukowalnych znaków ASCII bez spacji. Duplikat operacji będącej w toku może zwrócić 409 z Retry-After. Dla zakończonych żądań odtwarzana jest zapisana odpowiedź, w tym błędy. Przestrzegaj limitów częstotliwości żądań.

Po błędzie transportu może pojawić się zapisana w pamięci podręcznej odpowiedź 502. Zapisana w pamięci podręcznej odpowiedź 500 z requestId może oznaczać, że rejestr przyjął operację, ale lokalny zapis lub rozliczenie się nie powiodły. Zachowaj identyfikator żądania, sprawdź aktualne rekordy i wyjaśnij stan operacji z pomocą techniczną przed użyciem nowego klucza. Nie zakładaj, że błąd oznacza brak zamówienia.