Provjerite rezultate provjere robne marke

Odaberite robnu marku koju provjeravate

Upotrijebite identifikator robne marke sa svojeg računa. Čuvajte ga uz dobivene zapise o provjeri kako se provjera jednog poduzeća ne bi zamijenila s provjerom drugog poduzeća. Nemojte upotrebljavati identifikatore drugog računa.

Pratite postojeću provjeru

Sačuvajte vettingId, evpId, vettingClass i vettingStatus ako su prisutni. Trenutačna sinkronizacija tretira PENDING i UNSCORE kao rezultate koji još čekaju daljnju provjeru, a ACTIVE i FAILED kao konačne rezultate za obračun. Pročitajte vraćene pojedinosti prije nego što odlučite jesu li potrebne daljnje radnje. Sam prazan popis nije dokaz da prethodno poslani zahtjev nije stigao u registar.

Razumijte naknade za prethodnu narudžbu

Provjerom statusa ne naručujete novu provjeru. Međutim, ona može uskladiti dovršeni rezultat i obračunati naknadu povezanu s prethodnim naplativim zahtjevom za provjeru. To uključuje i primjenjivu naknadu za neuspješnu provjeru. Primijenite cijenu i uvjete koje ste pregledali prilikom naručivanja; nemojte zaključivati o današnjoj cijeni na temelju starog primjera ili odgovora o statusu.

Ponovite čitanje bez slanja nove narudžbe

U slučaju privremene pogreške sačuvajte identifikator robne marke i poznate identifikatore provjere, poštujte Retry-After i ponovite ovo čitanje uz postupno produljivanje razmaka između pokušaja. Nemojte slati novu narudžbu za provjeru samo zato što dohvat statusa nije uspio ili je vratio neočekivani sadržaj odgovora. Ako se nepodudaranje nastavi, obratite se MultiTEL-u s relevantnim referentnim identifikatorima putem autentificiranog kanala za podršku.

Držite korake registracije odvojenima

Provjerom se utvrđuje rezultat provjere robne marke. Utvrđivanje prihvatljivosti kampanje, registracija kampanje i dodjela brojeva i dalje su zasebni koraci. Prije slanja poruka provjerite njihov trenutačni status i zahtjeve.

Zahtjev

Upotrijebite omogućen račun za API putem protokola HTTPS s dopuštene izvorišne IP adrese. Upotrijebite vjerodajnice svojeg računa, a ne vjerodajnice registra. Robna marka mora biti povezana s autentificiranim računom.

Pošaljite zahtjev GET s identifikatorom robne marke u putanji i obveznim filtrom upita vettingStatus. Pregledana shema definira polje statusa; ovaj primjer traži jednu vrijednost ACTIVE. Ovim vodičem nije utvrđeno kodiranje više vrijednosti ni prihvaća li pružatelj zahtjeve bez filtra. Tijelo zahtjeva nije potrebno.

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

Odgovor

Trenutačna ruta zadržava status HTTP i tijelo odgovora registra umjesto da upotrebljava staru omotnicu odgovora v3. Skraćeno izmišljeno polje prikazuje polja koja se upotrebljavaju u lokalnom postupku sinkronizacije; to nije snimljeni odgovor registra ni zajamčeno potpuna shema. Prije čitanja zapisa provjerite status HTTP i JSON. Čuvajte svaki vettingId uz odabranu robnu marku.

Ilustrativna struktura odgovora; nije riječ o stvarnim podacima računa ni o aktualnoj ponudi cijene.

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

Pogreške

• 401: Autentifikacija računa nije uspjela. Provjerite vjerodajnice, je li API omogućen i primjenjiva ograničenja izvorišnih IP adresa.
• 404: Robna marka nije povezana s ovim računom ili je registar nije mogao pronaći. Odbijanje zbog nepripadanja računu događa se prije slanja zahtjeva registru.
• 429: Dosegnuto je ograničenje broja zahtjeva za račun ili registar. Poštujte Retry-After i postupno produljujte razmake između pokušaja.
• 502/503: Prijenos, registar, mehanizam za ograničavanje zahtjeva ili lokalna obrada nisu dostupni. Pogreška ne dokazuje da prethodni zahtjev za provjeru nije uspio.

Dostupnost i popratni učinci

• Ovaj zahtjev GET ne stvara novu narudžbu za provjeru. Dohvaća rezultate iz registra, zapisuje revizijske zapise zahtjeva i sinkronizira pohranjene rezultate.
• Čitanjem dovršenog rezultata može se obračunati naknada za prethodno poslanu naplativu narudžbu za provjeru. Za neuspješnu provjeru može se primjenjivati naknada za neuspjeh. Pregledajte cijenu i uvjete prilikom naručivanja; ovo čitanje nije ponuda cijene.
• Novootkriveni zapis uvezen ovim zahtjevom GET ne razvrstava se automatski kao nova naplativa narudžba.
• Uspješan rezultat provjere ili rezultat sa statusom ACTIVE nije odobrenje kampanje, dodjela telefonskog broja ni dopuštenje za slanje poruka.