Programeri

PUT/tcr/v2/brand/{brandId}/revet

Ponovno provjerite robnu marku za razmjenu poruka

Nakon ispravka postojećeg poslovnog profila pošaljite jednu provjeru identiteta koja se zasebno naplaćuje, a zatim pratite rezultat.

Na ovoj stranici
  1. Ponovno provjerite ispravljeni identitet tvrtke
  2. Pregledajte robnu marku prije slanja
  3. Potvrdite zasebnu naknadu
  4. Pošaljite jedan planirani pokušaj
  5. Pročitajte rezultat i pratite njegov status
  6. Razjasnite neizvjestan rezultat
  7. Upotreba korisničkog portala

Ponovno provjerite ispravljeni identitet tvrtke

Upotrijebite ovu operaciju kada je potrebno ponovno provjeriti ispravljene podatke o identitetu postojeće robne marke organizacije. Najprije ažurirajte postojeću robnu marku, a zatim očitajte njezin trenutačni status identiteta. Uobičajeno ažuriranje profila ne šalje ovaj zaseban pokušaj koji se naplaćuje. Ponovna provjera ne stvara drugu robnu marku niti registrira kampanju.

Upotrijebite vlastiti omogućeni račun za API putem protokola HTTPS s dopuštene izvorne IP adrese. Robna marka mora pripadati tom računu. Čuvajte povjerljivost zapisa o robnim markama: sadrže poslovne i kontaktne podatke.

Pregledajte robnu marku prije slanja

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
  --output current-brand.json

Provjerite predstavlja li vraćena robna marka željenu tvrtku i je li ispravak prisutan. Izvorna registracija koja je još na čekanju ne može se ponovno provjeriti. Registar može odbiti zahtjev ako poslovni podaci nisu promijenjeni. Ako nedostaju posebni atributi, možda će biti potrebna žalba umjesto još jedne provjere identiteta. Robne marke samostalnih poduzetnika koriste odgovarajući postupak provjere identiteta/PIN-a; nemojte ovu krajnju točku smatrati zamjenom za taj postupak.

Potvrdite zasebnu naknadu

Trenutačno postavljena naknada za ponovnu provjeru u produkcijskom okruženju iznosi US$5.00 po prihvaćenom pokušaju, provjereno 24. listopada 2026. Primjenjuje se standardna naknada za robnu marku, čak i kada izvorni subjekt ima drukčiju cijenu registracije. Kupnje moraju biti omogućene; računi s plaćanjem unaprijed moraju imati dovoljno sredstava prije slanja.

Odgovor 202 znači da je zahtjev prihvaćen za daljnju obradu, a naknada se šalje na naplatu pri prihvaćanju. To ne znači da je tvrtka provjerena. Kasniji novi pokušaj može uzrokovati dodatnu naknadu. Nemojte stvarati novi pokušaj samo zato što je provjera još na čekanju.

Pošaljite jedan planirani pokušaj

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"

Nije potrebno tijelo zahtjeva s profilom: provjeravaju se već pohranjeni podaci o robnoj marki. Upotrijebite jedinstveni ključ idempotentnosti za planirani pokušaj, a pri ponavljanjima zadržite potpuno istu metodu, putanju, upit i tijelo zahtjeva. Ključevi podržavaju 1–128 ispisivih znakova ASCII bez razmaka. Duplikat pokušaja koji je u tijeku može vratiti 409 uz Retry-After; dovršeni pokušaj može ponovno vratiti svoj spremljeni rezultat, uključujući pogrešku.

Javni API prihvaća i autentifikaciju Bearer za omogućeni račun s tokenom. Provjere vlasništva računa i dopuštene izvorne IP adrese i dalje se primjenjuju. Pohranjene simulirane robne marke preskaču ovaj postupak naplate produkcijske naknade, ali rezultat iz testnog okruženja nije provjera identiteta u produkcijskom okruženju.

Pročitajte rezultat i pratite njegov status

Odgovori ponovne provjere
OdgovorZnačenje i sljedeća radnja
200Zahtjev je uspio. Pregledajte vraćenu robnu marku i ponovno pročitajte trenutačni zapis o robnoj marki kako biste potvrdili status identiteta.
202Prihvaćeno, čeka daljnju provjeru. Sačuvajte ID robne marke i naknadno provjerite njezin trenutačni status bez slanja još jednog pokušaja koji se naplaćuje.
400Pregledajte vraćene pogreške registra. Izvorna registracija možda je na čekanju, profil možda nije promijenjen ili se možda primjenjuje drugo pravilo validacije.
401 / 404Provjerite vjerodajnice i dopuštenu IP adresu ili ID robne marke koja pripada računu.
402 / 503Pregledajte lokalnu pogrešku kupnje/financiranja ili određivanja cijene/usluge. Nemojte pretpostaviti da svaki odgovor 503 dokazuje da zahtjev nije poslan nadređenoj usluzi.
429Poštujte Retry-After i zadržite iste podatke pokušaja.

Posrednički poslužitelj osvježava svoj lokalni zapis o robnoj marki nakon prihvaćene promjene; samo to osvježavanje ne dokazuje konačni ishod provjere. Tvrtka može ostati neprovjerena ili na čekanju. Prije nastavka postavljanja kampanje oslonite se na trenutačni status robne marke, a ne samo na prihvaćanje putem protokola HTTP.

Razjasnite neizvjestan rezultat

Pogreška u prijenosu može uzrokovati predmemorirani odgovor 502. Zahtjev prihvaćen u nadređenoj usluzi, nakon kojeg dođe do pogreške lokalne trajne pohrane ili naplate, može uzrokovati predmemorirani odgovor 500 s identifikatorom requestId. Sačuvajte taj identifikator i uz pomoć podrške uskladite trenutačno stanje robne marke i naplate. Generiranjem drugog ključa može nastati zasebno naplativ pokušaj; nemojte naslijepo ponavljati zahtjev s novim ključem.

Upotreba korisničkog portala

Portal nudi ponovnu provjeru za organizaciju u produkcijskom okruženju sa statusom UNVERIFIED nakon pregleda trenutačnog profila i naknade. Provjerava jesu li profil i cijena ostali nepromijenjeni te odbija dodatno prihvaćanje zahtjeva s istim trenutačnim podacima. Robne marke u testnom okruženju i robne marke samostalnih poduzetnika isključene su iz ove radnje na portalu.

Te zaštitne mjere portala dodatne su provjere u tijeku rada. Klijenti koji izravno koriste API moraju provesti vlastiti pregled i ne smiju pretpostaviti da API zahtijeva polja portala za verziju ili potvrdu cijene. Spremanje uobičajenog ispravka robne marke zasebna je radnja i ne šalje automatski zahtjev za ponovnu provjeru.