Registreer 'n boodskaphandelsmerk

Registreer die besigheid agter jou boodskappe

'n Boodskaphandelsmerk identifiseer die besigheid wat US 10DLC-boodskappe stuur. Registreer die handelsmerk voordat jy 'n veldtoggebruiksgeval kies. Gebruik die besigheid se wettige besonderhede en 'n kontakpersoon wat enige vereiste validering kan voltooi. 'n Teruggestuurde handelsmerk-ID is nie op sigself goedkeuring om boodskappe te stuur nie.

Gebruik hierdie huidige rekeninggebonden roete oor HTTPS met 'n geaktiveerde API-rekening en sy toegelate bron-IP-adres. Moenie user_id, username of 'n ander kliënt se eienaaridentifiseerder indien nie. MultiTEL teken eienaarskap vanaf die geoutentiseerde rekening aan.

Begin met 'n eksplisiete sandbox-versoek

Die portaal verstek sy vorm na sandbox-mode; 'n direkte API-versoek moet die JSON-boolese mock: true eksplisiet insluit wanneer jy 'n nabootsingshandelsmerk bedoel. Om daardie vlag weg te laat is nie 'n sandbox-waarborg nie en kan 'n betaalbare produksieregistrasie skep. Die portaal se mode-veld is nie 'n plaasvervanger vir die API se mock-veld nie.

Berei 'n plaaslike brand.json-lêer voor met die velde hieronder. Vervang die plekhouers met gepaste toetsbesonderhede en huidige kataloguskodes. Hierdie voorbeeld is 'n privaat-winsgewende besigheid; ander entiteitstipes het verskillende vereistes.

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

Die besigheid, adres, telefoon en identifiseerder hierbo is plekhouers, nie 'n sake-identiteit wat gereed is vir registrasie nie. Kry huidige waardes vir entityType, vertical, country, state, brandRelationship en ander enumerasies vanaf die boodskapkatalogusse.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand.json \
  'https://api.multitel.net/tcr/v2/brand/nonBlocking'

Besigheids- en kontakvelde

Alleeneienaars word vir US- of Kanadese registrasies ondersteun en benodig OTP-verifikasie voor veldtogkwalifisering. Openbare maatskappye kan 'n besigheidskontak-valideringstap vereis. GOVERNMENT is vir US-gebaseerde regeringsentiteite; bevestig die korrekte entiteitskategorie vir ander organisasies. Volg die entiteitspesifieke vereistes sowel as die teruggestuurde valideringsfoute.

Behou 'n stabiele idempotensiesleutel

Genereer een Idempotency-Key vir hierdie beoogde registrasie. Dit moet 1–128 drukbare ASCII-karakters sonder spasies bevat. Hergebruik dieselfde sleutel slegs met dieselfde HTTP-metode, pad, navraagstring en presiese versoekliggaamgrepe. Herformatering van JSON, selfs sonder om die betekenis te verander, verander die versoekvingerafdruk.

'n Voltooide gesleutelde versoek kan sy gestoorde antwoord herhaal sonder nog 'n registrasie-indiening. 'n Duplikaat wat nog verwerk word, gee HTTP 409 terug en kan Retry-After insluit. 'n Gewysigde versoek met dieselfde sleutel bots. Moenie 'n nuwe sleutel genereer bloot omdat 'n versoek uitgetel het of 'n fout teruggestuur het nie: die besigheid is moontlik reeds geregistreer.

Hou brand.json onveranderd terwyl jy daardie versoek oplos. 'n Gekaste 500 of 502 kan die oorspronklike fout herhaal eerder as om die registrasie weer te probeer. Behou enige teruggestuurde brandId, requestId en korrelasieopskrifte; rekonsilieer die bestaande handelsmerk voordat jy 'n ander versoek begin.

Lees die handelsmerk en sy status

Hierdie API gebruik HTTP-statuskodes en 'n direkte JSON-liggaam, eerder as die v3-status/response-koevert. Suksesvolle registrasie gee 'n handelsmerkobjek terug wat brandId insluit. Stoor daardie identifiseerder en inspekteer die teruggestuurde validering- of identiteitstatus. Ekstra velde hang van die entiteit en registrasiestatus af.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Lees slegs 'n handelsmerk wat aan jou rekening behoort. 'n 404 kan beteken dat die handelsmerk nie vir hierdie rekening beskikbaar is nie. Voltooi enige vereiste validering, gebruik dan handelsmerkkwalifisering om sy beskikbare veldtoggebruiksgevalle te vind. Nabootsingshulpbronne kan nie as geskik vir produksieversending aanvaar word nie.

Produksiefooie

Hierdie kleinhandelbedrae is op 24 Oktober 2026 teen die huidige portaalopstelling nagegaan. Bevestig die huidige fooi in die portaal voor produksieregistrasie. Veldtogheffings, bykomende keuring en boodskapgebruik is apart. 'n Produksieregistrasie kontroleer aankoopmagtiging en beskikbare befondsing voor indiening; suksesvolle registrasie van die handelsmerk in die register en plaaslike fakturering is aparte verwerkingstappe, so behou die hulpbron-ID en rekonsilieer transaksies indien 'n fout of faktureringskwessie voorkom.

Om 'n nabootsingshandelsmerk na produksie te verander is 'n apart bevestigde werkvloei en kan 'n nuwe produksie-identiteit en heffing skep. Moenie aanvaar dat die wysiging van mock na false in 'n latere versoek die bestaande handelsmerk omskakel nie.

Hanteer foute sonder om die handelsmerk te dupliseer