Kontroller den rettede bedriftsidentiteten på nytt
Bruk denne operasjonen når de rettede identitetsopplysningene for en eksisterende organisasjonsmerkevare må kontrolleres på nytt. Først må du oppdatere den eksisterende merkevaren, og deretter hente gjeldende identitetsstatus. En vanlig profiloppdatering sender ikke inn dette separate, betalte forsøket. Ny verifisering oppretter ikke en ny merkevare og registrerer ikke en kampanje.
Bruk din egen aktiverte API-konto over HTTPS fra en tillatt kilde-IP-adresse. Merkevaren må tilhøre denne kontoen. Hold merkevareoppføringene private: de inneholder bedrifts- og kontaktopplysninger.
Gjennomgå merkevaren før innsending
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.jsonKontroller at den returnerte merkevaren er den tiltenkte bedriften, og at rettelsen er med. En opprinnelig registrering som fortsatt venter på behandling, kan ennå ikke verifiseres på nytt. Registeret kan avvise en forespørsel når bedriftsopplysningene er uendret. Manglende særskilte attributter kan kreve en klage fremfor en ny identitetskontroll. Merkevarer for enkeltpersonforetak bruker den aktuelle arbeidsflyten for identitet/PIN; ikke bruk dette endepunktet som en erstatning.
Bekreft det separate gebyret
Det gjeldende konfigurerte gebyret for ny verifisering i produksjonsmiljøet er US$5.00 per akseptert forsøk, kontrollert 24. oktober 2026. Standardgebyret for merkevarer brukes, også når den opprinnelige enheten har en annen registreringspris. Kjøp må være aktivert; forhåndsbetalte kontoer må ha tilstrekkelig saldo før innsending.
Et 202-svar betyr at forespørselen er akseptert for videre behandling, og at gebyret sendes til belastning ved aksept. Det betyr ikke at bedriften er verifisert. Et nytt forsøk senere kan medføre et nytt gebyr. Ikke opprett et nytt forsøk bare fordi verifiseringen fortsatt venter på behandling.
Send inn ett tiltenkt forsøk
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"Ingen forespørselskropp med profilopplysninger kreves: dette kontrollerer merkevareopplysningene som allerede er lagret. Bruk en unik idempotensnøkkel for det tiltenkte forsøket, og behold nøyaktig samme metode, sti, spørring og forespørselskropp ved gjentatte forespørsler. Nøkler støtter 1–128 utskrivbare ASCII-tegn uten mellomrom. En duplikatforespørsel mens behandlingen pågår, kan returnere 409 med Retry-After; et fullført forsøk kan returnere det lagrede resultatet på nytt, inkludert en feil.
Det offentlige API-et godtar også Bearer-autentisering for en aktivert tokenkonto. Kontrollene av kontoeierskap og tillatt kilde-IP-adresse gjelder fortsatt. Lagrede simulerte merkevarer hopper over denne gebyrbehandlingen for produksjonsmiljøet, men et resultat fra sandkassen er ikke identitetsverifisering i produksjonsmiljøet.
Les resultatet og følg med på statusen
| Svar | Betydning og neste handling |
|---|---|
| 200 | Forespørselen var vellykket. Undersøk den returnerte merkevaren og hent den gjeldende merkevareoppføringen på nytt for å bekrefte identitetsstatusen. |
| 202 | Akseptert, venter på videre verifisering. Ta vare på merkevare-ID-en og kontroller gjeldende status senere uten å sende inn et nytt betalt forsøk. |
| 400 | Gjennomgå de returnerte feilene fra registeret. Den opprinnelige registreringen kan vente på behandling, profilen kan være uendret, eller en annen valideringsregel kan gjelde. |
| 401 / 404 | Kontroller påloggingsopplysningene og tillatt IP-adresse, eller ID-en til merkevaren som tilhører kontoen. |
| 402 / 503 | Gjennomgå den lokale feilen knyttet til kjøp eller dekning, eller feilen knyttet til pris eller tjeneste. Ikke anta at hvert 503-svar beviser at ingen forespørsel ble sendt til det overordnede systemet. |
| 429 | Følg Retry-After og behold de samme opplysningene for forsøket. |
Proxyen oppdaterer sin lokale merkevareoppføring etter en akseptert endring; denne oppdateringen beviser ikke i seg selv et endelig verifiseringsresultat. En bedrift kan fortsatt være uverifisert eller vente på behandling. Bruk gjeldende merkevarestatus fremfor bare aksept på HTTP-nivå før du fortsetter med kampanjeoppsettet.
Avklar et usikkert resultat
En transportfeil kan gi et hurtigbufret 502-svar. En forespørsel som er akseptert i det overordnede systemet, etterfulgt av en feil ved lokal varig lagring eller fakturering, kan gi et hurtigbufret 500-svar med requestId. Ta vare på denne identifikatoren og avstem gjeldende merkevare- og faktureringsstatus med kundestøtte. Å generere en ny nøkkel kan opprette et separat fakturerbart forsøk; ikke prøv på nytt med en ny nøkkel uten å avklare situasjonen.
Bruke kundeportalen
Portalen tilbyr ny verifisering for en organisasjon i produksjonsmiljøet med status UNVERIFIED etter gjennomgang av gjeldende profil og gebyr. Den kontrollerer at profilen og prisen ikke er endret, og avviser en ny innsending med de samme gjeldende opplysningene dersom en innsending allerede er akseptert. Merkevarer i sandkassen og merkevarer for enkeltpersonforetak er utelukket fra denne portalhandlingen.
Disse sikkerhetstiltakene i portalen er tilleggskontroller i arbeidsflyten. Direkte API-klienter må utføre sin egen gjennomgang og må ikke anta at API-et krever portalens felt for versjon eller prisbekreftelse. Å lagre en vanlig rettelse av merkevaren er en separat handling og sender ikke automatisk inn en forespørsel om ny verifisering.