Utvecklare

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

Verifiera ett meddelandevarumärke på nytt

Skicka in en separat debiterad identitetskontroll efter att ha korrigerat en befintlig företagsprofil och följ sedan resultatet.

På denna sida
  1. Kontrollera företagets korrigerade identitetsuppgifter på nytt
  2. Granska varumärket innan du skickar in begäran
  3. Bekräfta den separata avgiften
  4. Skicka in ett enda avsett försök
  5. Läs resultatet och följ statusen
  6. Red ut ett osäkert resultat
  7. Använda kundportalen

Kontrollera företagets korrigerade identitetsuppgifter på nytt

Använd den här åtgärden när de korrigerade identitetsuppgifterna för ett befintligt organisationsvarumärke behöver kontrolleras på nytt. Börja med att uppdatera det befintliga varumärket, och läs sedan dess aktuella identitetsstatus. En vanlig profiluppdatering skickar inte in detta separata avgiftsbelagda försök. Omverifiering skapar inte ett nytt varumärke och registrerar inte någon kampanj.

Använd ditt eget aktiverade API-konto via HTTPS från en tillåten käll-IP-adress. Varumärket måste tillhöra det kontot. Håll varumärkesposterna privata: de innehåller företags- och kontaktuppgifter.

Granska varumärket innan du skickar in begäran

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

Kontrollera att det returnerade varumärket avser rätt företag och att korrigeringen finns med. Om den ursprungliga registreringen fortfarande väntar på behandling kan den ännu inte omverifieras. Registret kan avvisa en begäran om företagsuppgifterna är oförändrade. Om särskilda attribut saknas kan ett överklagande krävas i stället för en ny identitetskontroll. Varumärken för enskilda näringsidkare använder det tillämpliga arbetsflödet för identitet/PIN; använd inte den här ändpunkten som ersättning.

Bekräfta den separata avgiften

Den för närvarande konfigurerade avgiften för omverifiering i produktionsmiljön är US$5.00 per accepterat försök, kontrollerad den 24 oktober 2026. Standardavgiften för varumärken används, även när den ursprungliga enheten har ett annat registreringspris. Köp måste vara aktiverade; förbetalda konton måste ha tillräckligt saldo innan begäran skickas in.

Ett 202-svar innebär att begäran har accepterats för fortsatt behandling och att avgiften skickas för debitering när begäran accepteras. Det innebär inte att företaget är verifierat. Ett nytt försök vid ett senare tillfälle kan medföra ytterligare en avgift. Skapa inte ett nytt försök enbart för att verifieringen fortfarande väntar på behandling.

Skicka in ett enda avsett försö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 profil krävs i begärans kropp: kontrollen gäller de varumärkesuppgifter som redan är lagrade. Använd en unik idempotensnyckel för det avsedda försöket och behåll exakt samma metod, sökväg, frågesträng och kropp vid återförsök. Nycklar stöder 1–128 utskrivbara ASCII-tecken utan blanksteg. En dubblett av ett pågående försök kan returnera 409 med Retry-After; ett slutfört försök kan återge sitt sparade resultat, även om resultatet är ett fel.

Det publika API:et accepterar även Bearer-autentisering för ett aktiverat tokenkonto. Kontroller av kontoägarskap och tillåten käll-IP-adress gäller fortfarande. För lagrade testvarumärken hoppas denna avgiftshantering för produktionsmiljön över, men ett resultat från sandlådemiljön är inte en identitetsverifiering i produktionsmiljön.

Läs resultatet och följ statusen

Svar vid omverifiering
SvarBetydelse och nästa åtgärd
200Begäran lyckades. Granska det returnerade varumärket och läs den aktuella varumärkesposten på nytt för att bekräfta identitetsstatusen.
202Accepterad, väntar på ytterligare verifiering. Spara varumärkets ID och kontrollera dess aktuella status senare utan att skicka in ett nytt avgiftsbelagt försök.
400Granska de returnerade registerfelen. Den ursprungliga registreringen kan vänta på behandling, profilen kan vara oförändrad eller en annan valideringsregel kan vara tillämplig.
401 / 404Kontrollera autentiseringsuppgifterna och den tillåtna IP-adressen, eller ID:t för varumärket som tillhör kontot.
402 / 503Granska det lokala felet som gäller köp, kontofinansiering, prissättning eller tjänst. Utgå inte från att varje 503 bevisar att ingen begäran skickades till den bakomliggande tjänsten.
429Följ Retry-After och behåll samma uppgifter för försöket.

Proxyn uppdaterar sin lokala varumärkespost efter en accepterad ändring; den uppdateringen bevisar inte i sig ett slutligt verifieringsresultat. Ett företag kan förbli overifierat eller vänta på behandling. Utgå från varumärkets aktuella status och inte enbart från att begäran accepterats via HTTP innan du fortsätter att konfigurera kampanjen.

Red ut ett osäkert resultat

Ett överföringsfel kan ge ett cachelagrat 502-svar. En begäran som accepterats av den bakomliggande tjänsten och därefter följs av ett lokalt lagrings- eller debiteringsfel kan ge ett cachelagrat 500-svar med requestId. Spara den identifieraren och stäm av varumärkets och debiteringens aktuella tillstånd med supporten. Om du genererar en annan nyckel kan ett separat debiterbart försök skapas; gör inte återförsök med en ny nyckel utan att först reda ut situationen.

Använda kundportalen

Portalen erbjuder omverifiering för en organisation i produktionsmiljön med status UNVERIFIED efter granskning av den aktuella profilen och avgiften. Den kontrollerar att profilen och priset inte har ändrats och avvisar ytterligare en inskickning som annars skulle accepteras för samma aktuella uppgifter. Varumärken i sandlådemiljön och varumärken för enskilda näringsidkare omfattas inte av denna portalåtgärd.

Dessa skydd i portalen är ytterligare kontroller i arbetsflödet. Direkta API-klienter måste göra en egen granskning och får inte utgå från att API:et kräver portalens fält för version eller prisbekräftelse. Att spara en vanlig korrigering av ett varumärke är en separat åtgärd och skickar inte automatiskt in en begäran om omverifiering.