Verifieer ’n boodskaphandelsmerk weer

Kontroleer die reggestelde besigheidsidentiteit weer

Gebruik hierdie bewerking wanneer die reggestelde identiteitsinligting van ’n bestaande organisasiehandelsmerk weer gekontroleer moet word. Werk eers die bestaande handelsmerk by, en lees dan die huidige identiteitstatus daarvan. ’n Gewone profielopdatering dien nie hierdie afsonderlike betaalde poging in nie. Herverifikasie skep nie nog ’n handelsmerk of registreer ’n veldtog nie.

Gebruik jou eie geaktiveerde API-rekening via HTTPS vanaf ’n toegelate bron-IP-adres. Die handelsmerk moet aan daardie rekening behoort. Hou handelsmerkrekords privaat: dit bevat besigheids- en kontakinligting.

Gaan die handelsmerk na voordat jy indien

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

Kontroleer dat die teruggestuurde handelsmerk die bedoelde besigheid is en dat die regstelling aangebring is. ’n Oorspronklike registrasie wat nog hangende is, kan nog nie weer geverifieer word nie. Die register kan ’n versoek verwerp wanneer die besigheidsinligting onveranderd is. Ontbrekende spesiale eienskappe kan ’n appèl vereis eerder as nog ’n identiteitskontrole. Handelsmerke van alleenhandelaars gebruik die toepaslike identiteits-/PIN-werkvloei; moenie hierdie eindpunt as ’n plaasvervanger beskou nie.

Bevestig die afsonderlike heffing

Die tans ingestelde herverifikasiefooi vir die produksieomgewing is US$5.00 per aanvaarde poging, nagegaan op 24 Oktober 2026. Die standaardhandelsmerkfooi word gebruik, ook wanneer die oorspronklike entiteit ’n ander registrasieprys het. Aankope moet geaktiveer wees; voorafbetaalde rekeninge moet genoeg saldo hê voordat die versoek ingedien word.

’n 202-respons beteken dat die versoek vir verdere verwerking aanvaar is, en die fooi word by aanvaarding vir heffing gestuur. Dit beteken nie dat die besigheid geverifieer is nie. ’n Latere nuwe poging kan nog ’n fooi meebring. Moenie ’n nuwe poging skep bloot omdat verifikasie nog hangende is nie.

Dien een beoogde poging in

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"

Geen versoekliggaam met profieldata word vereis nie: die handelsmerkbesonderhede wat reeds gestoor is, word gekontroleer. Gebruik ’n unieke idempotensiesleutel vir die beoogde poging, en hou die presiese metode, pad, navraag en liggaam onveranderd wanneer jy weer probeer. Sleutels ondersteun 1–128 drukbare ASCII-karakters sonder spasies. ’n Duplikaat wat nog verwerk word, kan 409 met Retry-After terugstuur; ’n voltooide poging kan sy gestoorde resultaat weer terugstuur, ook ’n fout.

Die openbare API aanvaar ook Bearer-stawing vir ’n geaktiveerde tokenrekening. Kontroles van rekeningeienaarskap en toegelate bron-IP-adresse geld steeds. Gestoorde gesimuleerde handelsmerke slaan hierdie produksiefooiproses oor, maar ’n resultaat uit die toetsomgewing is nie identiteitsverifikasie in die produksieomgewing nie.

Lees die resultaat en volg die status daarvan op

Herverifikasieresponse
Respons	Betekenis en volgende stap
200	Die versoek was suksesvol. Gaan die teruggestuurde handelsmerk na en lees die huidige handelsmerkrekord weer om die identiteitstatus te bevestig.
202	Aanvaar, met verdere verifikasie hangende. Bewaar die handelsmerk-ID en kontroleer die huidige status daarvan later sonder om nog ’n betaalde poging in te dien.
400	Gaan die teruggestuurde registerfoute na. Die oorspronklike registrasie kan nog hangende wees, die profiel kan onveranderd wees, of ’n ander valideringsreël kan geld.
401 / 404	Kontroleer die aanmeldbesonderhede en toegelate IP-adres, of die ID van die handelsmerk wat aan die rekening behoort.
402 / 503	Gaan die plaaslike fout met aankope, befondsing, pryse of die diens na. Moenie aanvaar dat elke 503 bewys dat geen versoek aan die stroomopdiens plaasgevind het nie.
429	Hou by Retry-After en behou dieselfde pogingbesonderhede.

Die instaanbediener verfris sy plaaslike handelsmerkrekord ná ’n aanvaarde wysiging; daardie verfrissing bewys nie op sigself ’n finale verifikasie-uitkoms nie. ’n Besigheid kan ongeverifieer bly of steeds op verifikasie wag. Gebruik die huidige handelsmerkstatus eerder as slegs HTTP-aanvaarding voordat jy met die veldtogopstelling voortgaan.

Klaar ’n onsekere resultaat op

’n Vervoerfout kan ’n 502 in die kasgeheue oplewer. ’n Versoek wat stroomop aanvaar is en daarna deur ’n plaaslike bergings- of faktureringsfout gevolg word, kan ’n 500 met requestId in die kasgeheue oplewer. Bewaar daardie identifiseerder en klaar die huidige handelsmerk- en faktureringstoestand saam met die ondersteuningspan op. Die skep van ’n ander sleutel kan ’n poging skep waarvoor afsonderlik gefaktureer word; moenie blindelings met ’n nuwe sleutel weer probeer nie.

Gebruik van die kliënteportaal

Die portaal bied herverifikasie vir ’n organisasie in die produksieomgewing met die status UNVERIFIED nadat die huidige profiel en heffing nagegaan is. Dit kontroleer dat die profiel en prys nie verander het nie en verwerp nog ’n indiening vir dieselfde huidige besonderhede as een reeds aanvaar is. Handelsmerke in die toetsomgewing en dié van alleenhandelaars is van hierdie portaalaksie uitgesluit.

Daardie portaalmaatreëls is bykomende werkvloeikontroles. Direkte API-kliënte moet hul eie hersiening uitvoer en moenie aanvaar dat die API die portaal se weergawe- of prysbevestigingsvelde vereis nie. Die stoor van ’n gewone handelsmerkregstelling is ’n afsonderlike aksie en dien nie outomaties ’n herverifikasieversoek in nie.