Udviklere

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

Verificér et beskedbrand igen

Indsend én identitetskontrol, der faktureres særskilt, efter at have rettet en eksisterende virksomhedsprofil, og følg derefter resultatet.

På denne side
  1. Kontrollér den rettede virksomhedsidentitet igen
  2. Gennemgå brandet før indsendelse
  3. Bekræft det særskilte gebyr
  4. Indsend ét planlagt forsøg
  5. Læs resultatet, og følg dets status
  6. Afklar et usikkert resultat
  7. Brug af kundeportalen

Kontrollér den rettede virksomhedsidentitet igen

Brug denne handling, når de rettede identitetsoplysninger for et eksisterende organisationsbrand skal kontrolleres igen. Start med at opdatere det eksisterende brand, og aflæs derefter dets aktuelle identitetsstatus. En almindelig profilopdatering indsender ikke dette særskilte, betalte forsøg. Genverificering opretter ikke et nyt brand og registrerer ikke en kampagne.

Brug din egen aktiverede API-konto via HTTPS fra en tilladt kilde-IP-adresse. Brandet skal tilhøre denne konto. Hold brandoplysninger fortrolige: De indeholder virksomheds- og kontaktoplysninger.

Gennemgå brandet før indsendelse

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

Kontrollér, at det returnerede brand er den tilsigtede virksomhed, og at rettelsen er med. En oprindelig registrering, der stadig afventer behandling, kan endnu ikke genverificeres. Registret kan afvise en anmodning, hvis virksomhedsoplysningerne er uændrede. Manglende særlige attributter kan kræve en klage frem for endnu en identitetskontrol. Brands for enkeltmandsvirksomheder bruger det relevante forløb til identitetskontrol/PIN; brug ikke dette slutpunkt som erstatning.

Bekræft det særskilte gebyr

Det aktuelt konfigurerede gebyr for genverificering i produktionsmiljøet er US$5.00 pr. accepteret forsøg, kontrolleret den 24. oktober 2026. Standardgebyret for brands anvendes, også når den oprindelige enhed har en anden registreringspris. Køb skal være aktiveret; forudbetalte konti skal have tilstrækkelig saldo før indsendelse.

Et 202-svar betyder, at anmodningen er accepteret til videre behandling, og at gebyret sendes til opkrævning ved accept. Det betyder ikke, at virksomheden er verificeret. Et senere nyt forsøg kan udløse endnu et gebyr. Opret ikke et nyt forsøg, blot fordi verificeringen stadig afventer behandling.

Indsend ét planlagt forsøg

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"

Der kræves ingen anmodningstekst med profiloplysninger: Handlingen kontrollerer de brandoplysninger, der allerede er gemt. Brug en unik idempotensnøgle til det planlagte forsøg, og bevar præcis samme metode, sti, forespørgsel og anmodningstekst ved gentagelser. Nøgler understøtter 1–128 udskrivbare ASCII-tegn uden mellemrum. En dublet af et igangværende forsøg kan returnere 409 med Retry-After; et afsluttet forsøg kan returnere sit gemte resultat igen, herunder en fejl.

Det offentlige API accepterer også Bearer-godkendelse for en aktiveret tokenkonto. Kontroller af kontoejerskab og tilladt kilde-IP-adresse gælder stadig. Gemte testbrands springer dette forløb til opkrævning af produktionsgebyret over, men et resultat fra sandkassemiljøet er ikke en identitetsverificering i produktionsmiljøet.

Læs resultatet, og følg dets status

Svar ved genverificering
SvarBetydning og næste handling
200Anmodningen lykkedes. Undersøg det returnerede brand, og læs den aktuelle brandpost igen for at bekræfte identitetsstatus.
202Accepteret, afventer yderligere verificering. Gem brandets ID, og kontrollér dets aktuelle status senere uden at indsende endnu et betalt forsøg.
400Gennemgå de returnerede fejl fra registret. Den oprindelige registrering kan afvente behandling, profilen kan være uændret, eller en anden valideringsregel kan være gældende.
401 / 404Kontrollér legitimationsoplysningerne og den tilladte IP-adresse eller ID'et for det brand, der tilhører kontoen.
402 / 503Gennemgå den lokale fejl vedrørende køb/finansiering eller prisfastsættelse/tjeneste. Antag ikke, at enhver 503 beviser, at der ikke blev sendt en anmodning til den bagvedliggende tjeneste.
429Overhold Retry-After, og bevar de samme oplysninger for forsøget.

Proxyen opdaterer sin lokale brandpost efter en accepteret ændring; denne opdatering beviser ikke i sig selv et endeligt verificeringsresultat. En virksomhed kan fortsat være uverificeret eller afvente behandling. Brug brandets aktuelle status frem for alene accept via HTTP, før du fortsætter opsætningen af kampagnen.

Afklar et usikkert resultat

En transportfejl kan give en cachelagret 502. En anmodning, der accepteres af den bagvedliggende tjeneste og efterfølges af en lokal lagrings- eller faktureringsfejl, kan give en cachelagret 500 med requestId. Gem denne identifikator, og afstem brandets aktuelle tilstand og faktureringsstatus med supporten. Generering af endnu en nøgle kan oprette et forsøg, der faktureres særskilt; prøv ikke blindt igen med en ny nøgle.

Brug af kundeportalen

Portalen tilbyder genverificering for en organisation i produktionsmiljøet med status UNVERIFIED, efter at den aktuelle profil og gebyret er gennemgået. Den kontrollerer, at profilen og prisen ikke er ændret, og afviser endnu en indsendelse, der ellers ville blive accepteret, for de samme aktuelle oplysninger. Brands i sandkassemiljøet og brands for enkeltmandsvirksomheder er udelukket fra denne portalhandling.

Disse sikkerhedsforanstaltninger i portalen er yderligere kontroller i arbejdsgangen. Direkte API-klienter skal foretage deres egen gennemgang og må ikke antage, at API kræver portalens felter til version eller prisbekræftelse. At gemme en almindelig rettelse af et brand er en særskilt handling og indsender ikke automatisk en anmodning om genverificering.