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.
Użyj istniejącego wyniku od dostawcy
Użyj PUT, aby powiązać istniejący wynik weryfikacji od obsługiwanego dostawcy ze swoją marką. Nie powoduje to zamówienia nowej weryfikacji. Uzyskaj prawidłowy identyfikator transakcji dostawcy i ewentualny token potwierdzający bezpośrednio od tego dostawcy oraz upewnij się, że raport dotyczy tego samego podmiotu gospodarczego.
AUTHPLUS nie obsługuje tego procesu importowania. Nadal obowiązują reguły dopasowania właściwe dla danego dostawcy; żądanie importu nie znosi tych reguł ani nie gwarantuje spełnienia warunków dla każdego zastosowania kampanii.
Przygotuj import
| Pole | Wartość |
|---|---|
| evpId | Identyfikator obsługiwanego dostawcy, 1–10 znaków. |
| vettingId | Rzeczywisty identyfikator transakcji weryfikacji u dostawcy, maksymalnie 255 znaków. Nie zastępuj go identyfikatorem marki ani nie wymyślaj identyfikatora. |
| vettingToken | Token potwierdzający, jeśli dostawca go wymaga, maksymalnie 65535 znaków. Traktuj go jako poufny i pomiń, gdy dostawca go nie wymaga. |
Utwórz vetting-import.json, używając rzeczywistych wartości od dostawcy. Nie wysyłaj pól oceny punktowej, statusu ani znacznika czasu przeznaczonych wyłącznie do odpowiedzi w przekonaniu, że mogą zmienić wynik.
Zaimportuj wynik jednokrotnie
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Zapoznaj się z istniejącymi opłatami
Nowo zaimportowany wynik nie jest rejestrowany przez ten serwer pośredniczący jako nowe płatne zamówienie. Nie anuluje to wcześniej zamówionej weryfikacji: jeśli dla tego samego vettingId istnieje już zamówienie oczekujące na wynik lub naliczenie opłaty, import wyniku ACTIVE lub FAILED może spowodować rozliczenie zapisanej dla niego opłaty. W tej gałęzi synchronizacji opłata za rekord, który został już obciążony, nie jest naliczana ponownie.
Śledź faktyczny wynik
Pomyślna odpowiedź HTTP może zawierać rekord weryfikacji, która nadal oczekuje na zakończenie. Zachowaj jego vettingId i sprawdzaj vettingStatus, uzasadnienia, ocenę punktową oraz daty rozpoczęcia i końca ważności, o ile są dostępne. PENDING i UNSCORE wymagają dalszego monitorowania; ACTIVE, FAILED i EXPIRED oznaczają różne wyniki. Samo przyjęcie żądania na poziomie HTTP nie potwierdza korzystnej oceny punktowej ani spełnienia warunków udziału w kampanii.
Wykorzystaj status weryfikacji zewnętrznej, aby śledzić rekord. Odczytanie lub zaimportowanie wyniku końcowego może spowodować rozliczenie wcześniejszego płatnego zamówienia; nie musi więc 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 żądania będącego w trakcie przetwarzania może zwrócić 409 z Retry-After. Dla zakończonych żądań ponownie zwracana jest zapisana odpowiedź, w tym błędy. Przestrzegaj limitów częstotliwości żądań.
Zapisany w pamięci podręcznej błąd 502 może wystąpić po awarii transportu. Zapisany w pamięci podręcznej błąd 500 z requestId może oznaczać, że rejestr przyjął operację, ale lokalny trwały zapis lub rozliczenie zakończyły się niepowodzeniem. 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.