Sprawdź wyniki weryfikacji marki

Wybierz markę, którą sprawdzasz

Użyj identyfikatora marki ze swojego konta. Zachowaj go wraz z uzyskanymi rekordami weryfikacji, aby nie pomylić weryfikacji jednej firmy z weryfikacją innej. Nie używaj identyfikatorów z innego konta.

Śledź trwającą weryfikację

Zachowaj wartości pól vettingId, evpId, vettingClass i vettingStatus, jeśli są dostępne. Obecny mechanizm synchronizacji traktuje PENDING i UNSCORE jako wyniki nadal oczekujące na dalsze sprawdzenie, a ACTIVE i FAILED jako wyniki końcowe na potrzeby rozliczenia. Przeczytaj zwrócone szczegóły, zanim zdecydujesz, czy potrzebne są dalsze działania. Sama pusta lista nie dowodzi, że wcześniejsze zgłoszenie nie dotarło do rejestru.

Poznaj opłaty za wcześniejsze zlecenie

Sprawdzenie statusu nie zleca kolejnej weryfikacji. Może jednak uzgodnić zakończony wynik i rozliczyć opłatę powiązaną z wcześniejszym płatnym zleceniem weryfikacji. Obejmuje to również ewentualną opłatę za weryfikację zakończoną niepowodzeniem. Kieruj się ceną i warunkami sprawdzonymi podczas składania zlecenia; nie wyciągaj wniosków o dzisiejszej cenie ze starego przykładu ani z odpowiedzi dotyczącej statusu.

Ponów odczyt bez składania kolejnego zlecenia

W przypadku przejściowego błędu zachowaj identyfikator marki i znane identyfikatory weryfikacji, przestrzegaj Retry-After i ponów ten odczyt, stopniowo wydłużając odstępy między próbami. Nie składaj nowego zlecenia weryfikacji tylko dlatego, że sprawdzenie statusu nie powiodło się lub zwróciło nieoczekiwaną treść odpowiedzi. Jeśli rozbieżność się utrzymuje, skontaktuj się z MultiTEL przez uwierzytelniony kanał wsparcia, podając odpowiednie identyfikatory referencyjne.

Traktuj etapy rejestracji oddzielnie

Weryfikacja ustala wynik oceny marki. Kwalifikacja kampanii, rejestracja kampanii i przypisanie numeru pozostają oddzielnymi etapami. Przed wysyłaniem wiadomości sprawdź ich aktualny status i wymagania.

Żądanie

Użyj konta z włączonym dostępem do API, łącząc się przez HTTPS z dozwolonego źródłowego adresu IP. Użyj danych uwierzytelniających swojego konta, a nie danych rejestru. Marka musi być powiązana z uwierzytelnionym kontem.

Żądanie GET z identyfikatorem marki w ścieżce i wymaganym filtrem zapytania vettingStatus. Sprawdzony schemat definiuje tablicę statusów; ten przykład zawiera jedną wartość ACTIVE. Ten przewodnik nie potwierdza sposobu kodowania wielu wartości ani akceptowania przez dostawcę żądań bez filtra. Treść żądania nie jest wymagana.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting?vettingStatus=ACTIVE"

Odpowiedź

Obecna trasa zachowuje status HTTP i treść odpowiedzi rejestru zamiast używać starszej struktury opakowującej odpowiedź v3. Skrócona, fikcyjna tablica przedstawia pola wykorzystywane przez lokalny mechanizm synchronizacji; nie jest przechwyconą odpowiedzią rejestru ani schematem o gwarantowanej kompletności. Przed odczytaniem rekordów sprawdź status HTTP i dane JSON. Zachowaj każdy vettingId wraz z wybraną marką.

Przykładowa struktura odpowiedzi; nie są to rzeczywiste dane konta ani aktualna oferta cenowa.

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

Błędy

• 401: Uwierzytelnienie konta nie powiodło się. Sprawdź dane uwierzytelniające, czy dostęp do API jest włączony oraz obowiązujące ograniczenia źródłowych adresów IP.
• 404: Marka nie jest powiązana z tym kontem lub rejestr nie mógł jej znaleźć. Odmowa z powodu braku przynależności marki do konta następuje przed wysłaniem żądania do rejestru.
• 429: Osiągnięto limit żądań konta lub rejestru. Przestrzegaj Retry-After i stopniowo wydłużaj odstępy między ponownymi próbami.
• 502/503: Transport, rejestr, mechanizm ograniczania żądań lub lokalne przetwarzanie są niedostępne. Błąd nie dowodzi, że wcześniejsze zlecenie weryfikacji zakończyło się niepowodzeniem.

Dostępność i skutki uboczne

• To żądanie GET nie składa nowego zlecenia weryfikacji. Pobiera wyniki z rejestru, zapisuje rekordy audytu żądania i synchronizuje zapisane wyniki.
• Odczyt zakończonego wyniku może rozliczyć opłatę za wcześniej złożone płatne zlecenie weryfikacji. Weryfikacja zakończona niepowodzeniem może wiązać się z odpowiednią opłatą. Sprawdź cenę i warunki podczas składania zlecenia; ten odczyt nie jest ofertą cenową.
• Nowo wykryty rekord zaimportowany przez to żądanie GET nie jest automatycznie klasyfikowany jako nowe płatne zlecenie.
• Wynik weryfikacji zakończonej powodzeniem lub ze statusem ACTIVE nie oznacza zatwierdzenia kampanii, przypisania numeru telefonu ani zezwolenia na wysyłanie wiadomości.