Riverifikoni një markë për mesazhe

Rikontrolloni identitetin e korrigjuar të biznesit

Përdoreni këtë veprim kur të dhënat e korrigjuara të identitetit të një marke ekzistuese të një organizate duhen kontrolluar përsëri. Fillimisht, përditësoni markën ekzistuese, pastaj shihni statusin aktual të identitetit të saj. Një përditësim i zakonshëm i profilit nuk e dërgon këtë përpjekje të veçantë me pagesë. Riverifikimi nuk krijon një markë tjetër dhe nuk regjistron një fushatë.

Përdorni llogarinë tuaj të aktivizuar të API përmes HTTPS, nga një adresë IP burimore e lejuar. Marka duhet t'i përkasë asaj llogarie. Mbajini private të dhënat e markës: ato përmbajnë të dhëna biznesi dhe kontakti.

Shqyrtoni markën përpara dërgimit

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

Kontrolloni që marka e kthyer përfaqëson biznesin e synuar dhe që korrigjimi është i pranishëm. Një regjistrim fillestar që është në pritje nuk mund të riverifikohet ende. Regjistri mund ta refuzojë një kërkesë kur të dhënat e biznesit nuk kanë ndryshuar. Mungesa e atributeve të veçanta mund të kërkojë një ankim në vend të një kontrolli tjetër identiteti. Markat e bizneseve me pronar të vetëm përdorin rrjedhën përkatëse të punës për identitetin/PIN; mos e trajtoni këtë pikë fundore si zëvendësim të saj.

Konfirmoni tarifimin e veçantë

Tarifa e riverifikimit e konfiguruar aktualisht për mjedisin e prodhimit është US$5.00 për çdo përpjekje të pranuar, e kontrolluar më 24 tetor 2026. Zbatohet tarifa standarde e markës, edhe kur subjekti fillestar ka një çmim tjetër regjistrimi. Blerjet duhet të jenë të aktivizuara; llogaritë me parapagim duhet të kenë gjendje të mjaftueshme përpara dërgimit.

Një përgjigje 202 do të thotë se kërkesa u pranua për përpunim të mëtejshëm dhe tarifimi dërgohet për zbatim në çastin e pranimit. Kjo nuk do të thotë se biznesi është verifikuar. Një përpjekje e re më vonë mund të sjellë një tarifë tjetër. Mos krijoni një përpjekje të re vetëm sepse verifikimi mbetet në pritje.

Dërgoni një përpjekje të vetme të synuar

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"

Nuk nevojitet një trup kërkese me profilin: kontrollohen të dhënat e markës që janë ruajtur tashmë. Përdorni një çelës unik idempotence për përpjekjen e synuar dhe mbani saktësisht të pandryshuara metodën, shtegun, parametrat e pyetjes dhe trupin gjatë riprovimeve. Çelësat mbështesin 1–128 karaktere të printueshme ASCII, pa hapësira. Një dublikatë e një përpjekjeje në proces mund të kthejë 409 me Retry-After; një përpjekje e përfunduar mund të kthejë përsëri rezultatin e saj të ruajtur, përfshirë një gabim.

API publike pranon gjithashtu autentikimin Bearer për një llogari të aktivizuar që përdor token. Kontrollet e përkatësisë së llogarisë dhe të adresës IP burimore të lejuar vazhdojnë të zbatohen. Markat e simuluara të ruajtura e anashkalojnë këtë rrjedhë tarifimi në prodhim, por një rezultat nga mjedisi i provave nuk është verifikim identiteti në prodhim.

Lexoni rezultatin dhe ndiqni statusin e tij

Përgjigjet e riverifikimit
Përgjigjja	Kuptimi dhe veprimi pasues
200	Kërkesa pati sukses. Shqyrtoni markën e kthyer dhe lexoni përsëri regjistrimin aktual të markës për të konfirmuar statusin e identitetit.
202	E pranuar, në pritje të verifikimit të mëtejshëm. Ruani identifikuesin e markës dhe kontrolloni statusin e saj aktual më vonë, pa dërguar një përpjekje tjetër me pagesë.
400	Shqyrtoni gabimet e kthyera nga regjistri. Regjistrimi fillestar mund të jetë në pritje, profili mund të jetë i pandryshuar ose mund të zbatohet një rregull tjetër validimi.
401 / 404	Kontrolloni kredencialet dhe adresën IP të lejuar, ose identifikuesin e markës që i përket llogarisë.
402 / 503	Shqyrtoni gabimin lokal të blerjes/financimit ose të çmimit/shërbimit. Mos supozoni se çdo përgjigje 503 provon që nuk është bërë asnjë kërkesë te shërbimi në rrjedhën e sipërme.
429	Respektoni Retry-After dhe ruani të njëjtat hollësi të përpjekjes.

Serveri ndërmjetës përditëson regjistrimin e vet lokal të markës pas një ndryshimi të pranuar; ky përditësim nuk provon në vetvete një rezultat përfundimtar të verifikimit. Një biznes mund të mbetet i paverifikuar ose në pritje. Përpara se të vazhdoni konfigurimin e fushatës, bazohuni te statusi aktual i markës dhe jo vetëm te pranimi HTTP.

Sqaroni një rezultat të pasigurt

Një dështim transporti mund të prodhojë një përgjigje 502 të ruajtur në memorien e përkohshme. Një kërkesë e pranuar nga shërbimi në rrjedhën e sipërme, e ndjekur nga një dështim i ruajtjes lokale ose i faturimit, mund të prodhojë një përgjigje 500 të ruajtur në memorien e përkohshme, me requestId. Ruajeni atë identifikues dhe sqaroni me ekipin e mbështetjes gjendjen aktuale të markës dhe të faturimit. Gjenerimi i një çelësi tjetër mund të krijojë një përpjekje që faturohet veçmas; mos riprovoni verbërisht me një çelës të ri.

Përdorimi i portalit të klientit

Portali ofron riverifikim për një organizatë në mjedisin e prodhimit me statusin UNVERIFIED, pas shqyrtimit të profilit aktual dhe tarifës. Ai kontrollon që profili dhe çmimi nuk kanë ndryshuar dhe refuzon një dërgim tjetër për të njëjtat të dhëna aktuale nëse ekziston tashmë një dërgim i pranuar. Markat e mjedisit të provave dhe ato të bizneseve me pronar të vetëm përjashtohen nga ky veprim i portalit.

Këto masa mbrojtëse të portalit janë kontrolle shtesë të rrjedhës së punës. Klientët që përdorin drejtpërdrejt API duhet të kryejnë shqyrtimin e tyre dhe nuk duhet të supozojnë se API kërkon fushat e portalit për versionin ose konfirmimin e çmimit. Ruajtja e një korrigjimi të zakonshëm të markës është një veprim i veçantë dhe nuk dërgon automatikisht një kërkesë për riverifikim.