Ponownie sprawdź poprawione dane tożsamości firmy
Użyj tej operacji, gdy poprawione dane tożsamości istniejącej marki organizacji wymagają ponownego sprawdzenia. Najpierw zaktualizuj istniejącą markę, a następnie odczytaj jej bieżący status tożsamości. Zwykła aktualizacja profilu nie zgłasza tej osobno płatnej próby. Ponowna weryfikacja nie tworzy kolejnej marki ani nie rejestruje kampanii.
Korzystaj z własnego aktywnego konta API przez HTTPS, z dozwolonego źródłowego adresu IP. Marka musi należeć do tego konta. Zachowaj poufność rekordów marek: zawierają dane firmowe i kontaktowe.
Sprawdź markę przed zgłoszeniem
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.jsonSprawdź, czy zwrócona marka odpowiada właściwej firmie i czy zawiera poprawkę. Jeśli pierwotna rejestracja nadal oczekuje na zakończenie, ponowna weryfikacja nie jest jeszcze możliwa. Rejestr może odrzucić żądanie, gdy dane firmy nie uległy zmianie. Brak specjalnych atrybutów może wymagać odwołania zamiast kolejnej weryfikacji tożsamości. W przypadku marek jednoosobowych działalności gospodarczych należy stosować odpowiednią procedurę weryfikacji tożsamości/PIN; nie traktuj tego punktu końcowego jako jej zamiennika.
Potwierdź osobną opłatę
Aktualnie skonfigurowana opłata za ponowną weryfikację w środowisku produkcyjnym wynosi US$5.00 za każdą przyjętą próbę, według stanu sprawdzonego 24 października 2026. Obowiązuje standardowa opłata za markę, również wtedy, gdy pierwotny podmiot ma inną cenę rejestracji. Zakupy muszą być włączone; konta przedpłacone muszą mieć wystarczające saldo przed zgłoszeniem.
Odpowiedź 202 oznacza, że żądanie przyjęto do dalszego przetwarzania, a opłatę przekazano do rozliczenia w chwili przyjęcia. Nie oznacza to, że firma została zweryfikowana. Późniejsza nowa próba może wiązać się z kolejną opłatą. Nie twórz nowej próby tylko dlatego, że weryfikacja nadal oczekuje na zakończenie.
Zgłoś jedną zaplanowaną próbę
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"Treść żądania z profilem nie jest wymagana: sprawdzane są już zapisane dane marki. Użyj unikatowego klucza idempotencji dla zaplanowanej próby i przy ponowieniach pozostaw dokładnie tę samą metodę, ścieżkę, zapytanie i treść żądania. Klucze mogą zawierać 1–128 drukowalnych znaków ASCII bez spacji. Duplikat próby będącej w toku może zwrócić 409 z Retry-After; dla zakończonej próby może zostać ponownie zwrócony zapisany wynik, w tym błąd.
Publiczne API obsługuje również uwierzytelnianie Bearer dla aktywnego konta korzystającego z tokenu. Nadal obowiązują kontrole przynależności do konta i dozwolonego źródłowego adresu IP. Zapisane symulowane marki pomijają tę ścieżkę naliczania opłaty produkcyjnej, ale wynik ze środowiska testowego nie stanowi weryfikacji tożsamości w środowisku produkcyjnym.
Odczytaj wynik i śledź status
| Odpowiedź | Znaczenie i następne działanie |
|---|---|
| 200 | Żądanie zakończyło się powodzeniem. Sprawdź zwróconą markę i ponownie odczytaj jej aktualny rekord, aby potwierdzić status tożsamości. |
| 202 | Przyjęto; trwa oczekiwanie na dalszą weryfikację. Zachowaj identyfikator marki i sprawdź jej bieżący status później, bez zgłaszania kolejnej płatnej próby. |
| 400 | Sprawdź błędy zwrócone przez rejestr. Pierwotna rejestracja może nadal oczekiwać na zakończenie, profil może pozostawać niezmieniony lub może mieć zastosowanie inna reguła walidacji. |
| 401 / 404 | Sprawdź dane uwierzytelniające i dozwolony adres IP albo identyfikator marki należącej do konta. |
| 402 / 503 | Sprawdź lokalny błąd zakupu lub zapewnienia środków albo błąd ustalania ceny lub usługi. Nie zakładaj, że każda odpowiedź 503 dowodzi, iż nie wysłano żądania do usługi nadrzędnej. |
| 429 | Przestrzegaj Retry-After i zachowaj te same dane próby. |
Serwer pośredniczący odświeża lokalny rekord marki po przyjęciu zmiany; samo odświeżenie nie potwierdza ostatecznego wyniku weryfikacji. Firma może nadal pozostawać niezweryfikowana lub oczekiwać na weryfikację. Przed kontynuowaniem konfiguracji kampanii kieruj się bieżącym statusem marki, a nie samym przyjęciem żądania na poziomie HTTP.
Wyjaśnij niepewny wynik
Błąd transmisji może spowodować zapisanie odpowiedzi 502 w pamięci podręcznej. Żądanie przyjęte przez usługę nadrzędną, po którym nastąpi błąd lokalnego zapisu trwałego lub rozliczenia, może spowodować zapisanie w pamięci podręcznej odpowiedzi 500 z requestId. Zachowaj ten identyfikator i uzgodnij ze wsparciem aktualny stan marki oraz rozliczeń. Wygenerowanie kolejnego klucza może utworzyć osobno płatną próbę; nie ponawiaj żądania pod nowym kluczem bez sprawdzenia sytuacji.
Korzystanie z portalu klienta
Portal umożliwia ponowną weryfikację organizacji w środowisku produkcyjnym o statusie UNVERIFIED po sprawdzeniu bieżącego profilu i opłaty. Sprawdza, czy profil i cena nie uległy zmianie, oraz uniemożliwia przyjęcie kolejnego zgłoszenia z tymi samymi aktualnymi danymi. Marki ze środowiska testowego oraz marki jednoosobowych działalności gospodarczych są wyłączone z tej operacji w portalu.
Te zabezpieczenia portalu stanowią dodatkowe kontrole przebiegu operacji. Klienci korzystający bezpośrednio z API muszą przeprowadzać własną kontrolę i nie mogą zakładać, że API wymaga pól wersji lub potwierdzenia ceny używanych przez portal. Zapisanie zwykłej poprawki danych marki jest osobnym działaniem i nie zgłasza automatycznie ponownej weryfikacji.