Sõnumsidebrändi korduskontroll

Kontrollige parandatud ettevõtte identiteediandmeid uuesti

Kasutage seda toimingut, kui olemasoleva organisatsiooni brändi parandatud identiteediandmeid on vaja uuesti kontrollida. Esmalt uuendage olemasolevat brändi, seejärel lugege selle praegust identiteediolekut. Tavaline profiili uuendamine ei esita seda eraldi tasulist kontrollitaotlust. Korduskontroll ei loo uut brändi ega registreeri kampaaniat.

Kasutage oma aktiveeritud API kontot lubatud lähte-IP-aadressilt HTTPS kaudu. Bränd peab kuuluma sellele kontole. Hoidke brändi kirjed privaatsena: need sisaldavad ettevõtte- ja kontaktandmeid.

Vaadake bränd enne esitamist üle

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

Kontrollige, et vastuses saadud bränd vastaks soovitud ettevõttele ja parandus oleks olemas. Kui esialgne registreerimine on veel ootel, ei saa korduskontrolli veel teha. Register võib taotluse tagasi lükata, kui ettevõtte andmed ei ole muutunud. Puuduvate eritunnuste korral võib uue identiteedikontrolli asemel olla vaja esitada vaie. Füüsilisest isikust ettevõtjate brändide puhul kasutatakse asjakohast identiteedi/PIN-i töövoogu; ärge kasutage seda lõpp-punkti selle asendusena.

Kinnitage eraldi tasu

Praegu seadistatud korduskontrolli tasu tootmiskeskkonnas on US$5.00 iga vastuvõetud kontrollitaotluse eest, kontrollitud 24. oktoobril 2026. Kohaldatakse brändi standardtasu ka siis, kui algse üksuse registreerimishind on erinev. Ostud peavad olema lubatud; ettemaksukontol peab enne esitamist olema piisav saldo.

Vastus 202 tähendab, et taotlus võeti edasiseks töötlemiseks vastu ja tasu sissenõudmine algatatakse vastuvõtmisel. See ei tähenda, et ettevõte oleks verifitseeritud. Hilisem uus kontrollitaotlus võib tuua kaasa uue tasu. Ärge looge uut kontrollitaotlust pelgalt seetõttu, et kontroll on endiselt ootel.

Esitage üks kavandatud kontrollitaotlus

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"

Profiiliandmetega päringukeha ei ole vaja: kontrollitakse juba salvestatud brändiandmeid. Kasutage kavandatud kontrollitaotluse jaoks kordumatut idempotentsusvõtit ning jätke korduskatsetel meetod, tee, päringuparameetrid ja keha täpselt samaks. Võtmed võivad sisaldada 1–128 prinditavat ASCII märki ilma tühikuteta. Veel töödeldava taotluse duplikaat võib tagastada vastuse 409 koos päisega Retry-After; lõpetatud kontrollitaotluse korral võidakse tagastada selle salvestatud tulemus, sealhulgas viga.

Avalik API toetab aktiveeritud pääsmepõhise konto puhul ka Bearer autentimist. Konto omandiõiguse ja lubatud lähte-IP-aadressi kontrollid kehtivad endiselt. Salvestatud imitatsioonibrändide puhul jäetakse see tootmiskeskkonna tasu töötlemine vahele, kuid liivakasti tulemus ei ole identiteedi kontrollimine tootmiskeskkonnas.

Lugege tulemust ja jälgige selle olekut

Korduskontrolli vastused
Vastus	Tähendus ja järgmine toiming
200	Taotlus õnnestus. Vaadake vastuses saadud bränd üle ja lugege praegune brändikirje uuesti, et kinnitada identiteediolek.
202	Vastu võetud, edasise kontrolli ootel. Säilitage brändi ID ja kontrollige selle praegust olekut hiljem, esitamata uut tasulist kontrollitaotlust.
400	Vaadake vastuses saadud registrivead üle. Esialgne registreerimine võib olla ootel, profiil võib olla muutmata või võib rakenduda mõni muu valideerimisreegel.
401 / 404	Kontrollige autentimisandmeid ja lubatud IP-aadressi või kontole kuuluva brändi ID-d.
402 / 503	Vaadake üle kohalik ostu või rahastamise viga või hinnastuse või teenuse viga. Ärge eeldage, et iga 503 tõendab, et ülesvoolu süsteemile päringut ei tehtud.
429	Järgige päist Retry-After ja jätke kontrollitaotluse andmed samaks.

Puhverserver värskendab oma kohalikku brändikirjet pärast muudatuse vastuvõtmist; see värskendus ei tõenda iseenesest kontrolli lõpptulemust. Ettevõte võib jääda verifitseerimata või ootele. Enne kampaania seadistamise jätkamist lähtuge brändi praegusest olekust, mitte üksnes taotluse vastuvõtmisest HTTP tasemel.

Selgitage välja ebaselge tulemus

Andmeedastuse tõrge võib põhjustada vahemällu salvestatud vastuse 502. Kui ülesvoolu süsteemis vastu võetud taotlusele järgneb kohalik andmete salvestamise või arvelduse tõrge, võib tulemuseks olla vahemällu salvestatud vastus 500 koos identifikaatoriga requestId. Säilitage see identifikaator ning selgitage koos klienditoega välja brändi ja arvelduse praegune seis. Uue võtme loomine võib tekitada eraldi tasustatava kontrollitaotluse; ärge proovige uue võtmega uuesti olukorda eelnevalt selgitamata.

Kliendiportaali kasutamine

Portaal pakub tootmiskeskkonna organisatsioonile olekuga UNVERIFIED korduskontrolli pärast praeguse profiili ja tasu ülevaatamist. See kontrollib, et profiil ja hind ei oleks muutunud, ning lükkab uue esituse tagasi, kui samade praeguste andmetega taotlus on juba vastu võetud. See portaali toiming ei ole saadaval liivakasti brändidele ega füüsilisest isikust ettevõtjate brändidele.

Need portaali kaitsemeetmed on töövoo lisakontrollid. Otse API kaudu töötavad kliendid peavad andmed ise üle vaatama ega tohi eeldada, et API nõuab portaali versiooni või hinnakinnituse välju. Tavalise brändiparanduse salvestamine on eraldi toiming ega esita automaatselt korduskontrolli taotlust.