Documentație API REST
API-uri REST pentru SMS și MMS
Trimiteți mesaje aprobate ale aplicației și gestionați acceptarea, evenimentele de livrare, segmentarea și taxele.
Alegeți împreună API-ul și credențialul
Conturile aprobate pentru Dezvoltatori și automatizare, Companii și Furnizori de comunicații pot integra serviciile activate. Un dezvoltator individual nu trebuie să pretindă că este o companie. SMS/MMS trimise de aplicații necesită aprobarea de trimitere și înregistrarea aplicabile. Serviciul pentru Persoane fizice și familii nu are un API de inițiere a mesajelor accesibil clienților.
| Familia API | URL de bază | Autentificare și rezultat |
|---|---|---|
| Comunicații v3 | https://api.multitel.net/v3 | Credențiale Basic aprobate; tokenuri provisionate eligibile numai pentru operațiunile care le acceptă. JSON status și response. |
| Înregistrare de urgență | https://api.multi.tel/emergency | Credențiale Basic aprobate sau acces bearer provisionat în mod specific. JSON code, message și data. |
| Integrări REST din portal | Gazda și operațiunea sunt afișate în referința pentru dezvoltatori a contului dumneavoastră | Utilizați credențialele, domeniile de acces și schema documentate pentru acea operațiune. Cererile din sesiunea browserului reprezintă un canal de acces separat. |
Setați MULTITEL_API_USERNAME și MULTITEL_API_PASSWORD prin configurația de secrete a serverului dumneavoastră înainte de a utiliza exemplele. Nu le încorporați niciodată în cod JavaScript public din browser, în URL-uri sau în controlul sursei. Credențialele dedicate sunt gestionate în setările de integrare API.
Pregătiți o cerere SMS
Utilizați un număr de expediere aprobat, activat pentru SMS, deținut de cont, un destinatar care și-a dat acordul pentru mesaj, precum și verificarea Brand/Campaign sau a numărului gratuit solicitată. Exemplul de mai jos trimite un mesaj real atunci când este completat cu credențiale și numere funcționale; nu este un mediu de test (sandbox).
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Înlocuiți substituenții expeditorului și destinatarului cu cifre internaționale care includ codul de țară. Pentru un MMS, furnizați URL-ul media public recuperabil acceptat în media și verificați mai întâi eligibilitatea și tarifele MMS.
Acceptarea nu înseamnă livrare
Inspectați atât starea aplicației exterioare, cât și rezultatul mesajului returnat. Înregistrați identificatorul mesajului furnizat de serviciu și urmăriți starea livrării și evenimentele webhook. O trimitere reușită nu poate dovedi că telefonul destinatarului a primit mesajul.
Facturarea SMS se face pe segment. Codificarea și lungimea mesajului pot produce mai multe segmente; taxele media și cele legate de operator pot diferi de cele pentru SMS. Citiți prețul de vânzare curent al contului înainte de trimitere. Nu reîncercați niciodată orbește o trimitere expirată: inspectați mai întâi rezultatul înregistrat al acesteia.
Gestionați erorile și reîncercările
- Eșec de autentificare sau de permisiune
- Verificați starea de activare a credențialului API, serviciul permis și restricția de IP sursă. Un cookie de sesiune din portal nu este un credențial de integrare.
- Credit insuficient sau aprobare lipsă
- Rezolvați soldul contului, aprobarea de trimitere sau cerința privind documentele înainte de a repeta operațiunea.
- Niciun rezultat
- Tratați inventarul gol sau lipsa numelui apelantului ca pe un rezultat obișnuit. Nu presupuneți că un număr valid din punct de vedere sintactic beneficiază de toate serviciile.
- Timeout de rețea sau defecțiune a serviciului
- Folosiți reîncercări limitate cu backoff pentru citiri. Pentru o achiziție, trimitere sau înregistrare, inspectați mai întâi starea operațiunii; reîncercarea unei cereri acceptate poate duplica o acțiune facturabilă.
Suportul pentru idempotență aparține fiecărei familii de API. API-ul pentru urgențe acceptă chei de reîncercare; acest lucru nu face ca cererile v3 arbitrare să fie idempotente. Păstrați marcajele de timp, ID-urile returnate și răspunsurile cu datele sensibile eliminate pentru asistență.
Continuați cu referința contului dvs.
Referința accesibilă după autentificare filtrează operațiunile în funcție de permisiunile și serviciile activate ale contului dvs. Folosiți gazda exactă, tipul de credențiale, câmpurile cererii și schema răspunsului indicate acolo. Consolele pot executa operațiuni reale, inclusiv achiziții și mesaje.