Registruokite pranešimų prekės ženklą

Registruokite verslą, slypintį už jūsų pranešimų

Pranešimų prekės ženklas nurodo verslą, siunčiantį US 10DLC pranešimus. Užregistruokite prekės ženklą prieš pasirinkdami kampanijos naudojimo atvejį. Naudokite teisinius verslo duomenis ir kontaktą, kuris gali atlikti reikiamą patvirtinimą. Grąžintas prekės ženklo ID savaime nėra leidimas siųsti pranešimus.

Naudokite šį dabartinį paskyrai priklausantį maršrutą per HTTPS su įjungta API paskyra ir jos leidžiamu šaltinio IP adresu. Nepateikite user_id, username ar kito kliento savininko identifikatoriaus. MultiTEL nuosavybę fiksuoja iš autentifikuotos paskyros.

Pradėkite nuo aiškios smėlio dėžės užklausos

Portalo formos lauke mode pagal numatytuosius nustatymus parinktas smėlio dėžės režimas; tiesioginė API užklausa, kai ketinate sukurti bandomąjį prekės ženklą, turi aiškiai nurodyti JSON loginę reikšmę mock: true. Šios vėliavėlės praleidimas negarantuoja smėlio dėžės ir gali sukurti apmokestinamą gamybinę registraciją. Portalo laukas mode nepakeičia API lauko mock.

Parenkite vietinį failą brand.json, naudodami toliau nurodytus laukus. Pakeiskite rezervuotas vietas tinkamais bandomaisiais duomenimis ir dabartiniais katalogų kodais. Šis pavyzdys yra privataus pelno verslas; kitų subjektų tipams taikomi kitokie reikalavimai.

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

Aukščiau pateiktas verslas, adresas, telefonas ir identifikatorius yra rezervuotos vietos, o ne registracijai paruošta verslo tapatybė. Dabartines entityType, vertical, country, state, brandRelationship ir kitų išvardijų reikšmes gaukite iš pranešimų katalogų.

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'

Verslo ir kontaktiniai laukai

Individualūs verslininkai palaikomi US arba Kanados registracijoms ir prieš įgydami teisę į kampaniją turi atlikti OTP patvirtinimą. Bendrovėms, kurių akcijomis prekiaujama viešai, gali reikėti verslo kontaktinio patvirtinimo veiksmo. GOVERNMENT skirta US įsikūrusiems valdžios subjektams; kitoms organizacijoms patvirtinkite tinkamą subjekto kategoriją. Laikykitės subjektui taikomų reikalavimų ir grąžintų patvirtinimo klaidų.

Išlaikykite stabilų idempotentumo raktą

Sugeneruokite vieną Idempotency-Key šiai numatytai registracijai. Jame turi būti 1–128 spausdinami ASCII simboliai be tarpų. Tą patį raktą naudokite pakartotinai tik su tuo pačiu HTTP metodu, keliu, užklausos eilute ir tiksliais užklausos turinio baitais. JSON performatavimas, net nekeičiant jo reikšmės, pakeičia užklausos kontrolinį atspaudą.

Užbaigta raktu pažymėta užklausa gali pakartoti išsaugotą atsakymą be kitos registracijos pateikimo. Vis dar apdorojamas dublikatas grąžina HTTP 409 ir gali nurodyti Retry-After. Pakeista užklausa su tuo pačiu raktu konfliktuoja. Negeneruokite naujo rakto vien todėl, kad užklausa pasibaigė arba grąžino klaidą: verslas gali būti jau užregistruotas.

Kol sprendžiate šią užklausą, nekeiskite brand.json. Talpykloje saugomas 500 arba 502 gali pakartoti pradinę klaidą, o ne pakartoti registraciją. Išsaugokite visus grąžintus brandId, requestId ir koreliacijos antraštes; prieš pradėdami kitą užklausą, patikrinkite faktinę esamo prekės ženklo būseną ir pašalinkite neatitikimus.

Skaitykite prekės ženklą ir jo būseną

Ši API naudoja HTTP būsenos kodus ir tiesioginį JSON turinį, o ne v3 status/response voką. Sėkminga registracija grąžina prekės ženklo objektą, įskaitant brandId. Išsaugokite šį identifikatorių ir patikrinkite grąžintą patvirtinimo arba tapatybės būseną. Papildomi laukai priklauso nuo subjekto ir registracijos būsenos.

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

Skaitykite tik jūsų paskyrai priklausantį prekės ženklą. 404 gali reikšti, kad prekės ženklas nepasiekiamas šiai paskyrai. Užbaikite reikiamą patvirtinimą, tada naudokite prekės ženklo kvalifikavimą, kad rastumėte galimus jo kampanijos naudojimo atvejus. Negalima manyti, kad bandomieji ištekliai tinkami gamybiniam siuntimui.

Gamybiniai mokesčiai

Šios mažmeninės sumos buvo patikrintos pagal dabartinę portalo konfigūraciją spalio 24 d., 2026 m. Prieš gamybinę registraciją patvirtinkite dabartinį mokestį portale. Kampanijos mokesčiai, papildomas tikrinimas ir pranešimų naudojimas yra atskiri. Gamybinė registracija prieš pateikimą patikrina pirkimo leidimą ir turimą finansavimą; sėkmingas prekės ženklo sukūrimas registre ir vietinis atsiskaitymas yra atskiri apdorojimo veiksmai, todėl išsaugokite ištekliaus ID ir patikrinkite operacijas ir pašalinkite neatitikimus, jei įvyksta klaida ar atsiskaitymo problema.

Bandomojo prekės ženklo keitimas į gamybinį yra atskirai patvirtinama darbo eiga ir gali sukurti naują gamybinę tapatybę bei mokestį. Nemanykite, kad mock redagavimas į false vėlesnėje užklausoje konvertuoja esamą prekės ženklą.

Tvarkykite klaidas nedubliuodami prekės ženklo