Reģistrējiet ziņojumapmaiņas zīmolu

Reģistrējiet uzņēmumu, kas sūta jūsu ziņojumus

Ziņojumapmaiņas zīmols identificē uzņēmumu, kas sūta US 10DLC ziņojumus. Reģistrējiet zīmolu pirms kampaņas lietošanas gadījuma izvēles. Izmantojiet uzņēmuma juridiskos datus un kontaktpersonu, kas var pabeigt nepieciešamo validāciju. Atgrieztais zīmola ID pats par sevi nav atļauja sūtīt ziņojumus.

Izmantojiet šo pašreizējo kontam piederošo maršrutu HTTPS savienojumā ar iespējotu API kontu un tā atļauto avota IP adresi. Neiesniedziet user_id, username vai cita klienta īpašnieka identifikatoru. MultiTEL reģistrē īpašumtiesības no autentificētā konta.

Sāciet ar nepārprotamu smilškastes pieprasījumu

Portāls pēc noklusējuma izvēlas smilškastes režīmu veidlapas mode laukā; tiešam API pieprasījumam nepārprotami jāiekļauj JSON Būla vērtība mock: true, ja paredzat testa zīmolu. Karodziņa izlaišana negarantē smilškasti un var izveidot apmaksājamu produkcijas reģistrāciju. Portāla mode lauks neaizstāj API mock lauku.

Sagatavojiet vietējo brand.json failu, izmantojot tālāk norādītos laukus. Aizstājiet vietturus ar atbilstošiem testa datiem un aktuālajiem katalogu kodiem. Šis piemērs ir privāts peļņas uzņēmums; citiem entītiju veidiem ir atšķirīgas prasības.

{
  "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
}

Iepriekš norādītais uzņēmums, adrese, tālrunis un identifikators ir vietturi, nevis reģistrācijai gatava uzņēmuma identitāte. Aktuālās vērtības laukiem entityType, vertical, country, state, brandRelationship un citām uzskaitēm skatiet ziņojumapmaiņas katalogus.

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'

Uzņēmuma un kontaktinformācijas lauki

Individuālie komersanti ir atbalstīti US vai Kanādas reģistrācijām un pirms kampaņas atbilstības tiem nepieciešama OTP verifikācija. Biržā kotētiem uzņēmumiem var būt nepieciešams uzņēmuma kontakta validācijas solis. GOVERNMENT ir paredzēts US valdības entītijām; citām organizācijām apstipriniet pareizo entītijas kategoriju. Ievērojiet entītijai specifiskās prasības, kā arī atgrieztās validācijas kļūdas.

Saglabājiet stabilu idempotences atslēgu

Izveidojiet vienu Idempotency-Key šai paredzētajai reģistrācijai. Tai jāsatur 1–128 drukājamas ASCII rakstzīmes bez atstarpēm. To pašu atslēgu atkārtoti izmantojiet tikai ar to pašu HTTP metodi, ceļu, vaicājuma virkni un tieši tiem pašiem pieprasījuma pamatteksta baitiem. JSON pārformatēšana, pat nemainot tā nozīmi, maina pieprasījuma pirkstu nospiedumu.

Pabeigts pieprasījums ar atslēgu var atkārtot saglabāto atbildi bez citas reģistrācijas iesniegšanas. Dublikāts, kas vēl tiek apstrādāts, atgriež HTTP 409 un var ietvert Retry-After. Mainīts pieprasījums ar to pašu atslēgu konfliktē. Neveidojiet jaunu atslēgu tikai tāpēc, ka pieprasījuma noildze iestājās vai tika atgriezta kļūda: uzņēmums, iespējams, jau ir reģistrēts.

Atrisinot šo pieprasījumu, nemainiet brand.json. Kešota 500 vai 502 kļūda var atkārtot sākotnējo kļūdu, nevis mēģināt reģistrāciju vēlreiz. Saglabājiet visus atgrieztos brandId, requestId un korelācijas galvenes; pirms cita pieprasījuma sākšanas pārbaudiet esošā zīmola faktisko stāvokli un novērsiet neatbilstības.

Lasiet zīmolu un tā statusu

Šis API izmanto HTTP statusa kodus un tiešu JSON pamattekstu, nevis v3 status/response aploksni. Veiksmīga reģistrācija atgriež zīmola objektu, tostarp brandId. Saglabājiet šo identifikatoru un pārbaudiet atgriezto validācijas vai identitātes statusu. Papildu lauki ir atkarīgi no entītijas un reģistrācijas stāvokļa.

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

Lasiet tikai savam kontam piederošu zīmolu. 404 var nozīmēt, ka zīmols šim kontam nav pieejams. Pabeidziet nepieciešamo validāciju un pēc tam izmantojiet zīmola kvalifikāciju, lai atrastu tā pieejamos kampaņas lietošanas gadījumus. Testa resursus nevar uzskatīt par atbilstošiem produkcijas sūtīšanai.

Produkcijas maksas

Šīs mazumtirdzniecības summas tika pārbaudītas pēc pašreizējās portāla konfigurācijas 24. oktobrī 2026. gadā. Pirms produkcijas reģistrācijas apstipriniet aktuālo maksu portālā. Kampaņas maksas, papildu pārbaude un ziņojumapmaiņas lietojums ir atsevišķi. Produkcijas reģistrācija pirms iesniegšanas pārbauda pirkšanas atļauju un pieejamo finansējumu; veiksmīga zīmola izveide reģistrā un vietējā norēķināšana ir atsevišķi apstrādes soļi, tāpēc saglabājiet resursa ID un saskaņojiet darījumus, ja rodas kļūda vai norēķinu problēma.

Testa zīmola mainīšana uz produkciju ir atsevišķi apstiprināma darbplūsma un var izveidot jaunu produkcijas identitāti un maksu. Nepieņemiet, ka mock rediģēšana uz false vēlākā pieprasījumā pārveido esošo zīmolu.

Apstrādājiet kļūdas, nedublējot zīmolu