Dokumentacioni i REST API
API REST për SMS dhe MMS
Dërgoni mesazhe të miratuara të aplikacionit dhe trajtoni pranimin, ngjarjet e dorëzimit, segmentimin dhe tarifat.
Zgjidhni API-në dhe kredencialin së bashku
Llogaritë e miratuara të kategorive Zhvillues dhe automatizim, Biznes dhe Ofrues të komunikimeve mund të integrojnë shërbimet e aktivizuara. Një zhvillues individual nuk ka nevojë të hiqet si kompani. SMS/MMS e aplikacionit kërkon miratimin dhe regjistrimin përkatës të dërgimit. Shërbimi Individë dhe familje nuk ka API të aksesueshme nga klienti për të nisur dërgimin e mesazheve.
| Familja API | URL bazë | Vërtetimi dhe rezultati |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | Kredenciale Basic të miratuara; tokenë të siguruar të pranueshëm vetëm për operacionet që i mbështesin. JSON status dhe response. |
| Regjistrimi për shërbimin e thirrjeve të emergjencës | https://api.multi.tel/emergency | Kredenciale Basic të miratuara ose akses bearer i siguruar posaçërisht. JSON code, message dhe data. |
| Integrimet REST të portalit | Hosti dhe operacioni tregohen në referencën e zhvilluesit të llogarisë suaj | Përdorni kredencialin, fushëveprimin e lejeve dhe skemën e dokumentuar të atij operacioni. Kërkesat e sesionit të shfletuesit përdorin një ndërfaqe të veçantë. |
Vendosni MULTITEL_API_USERNAME dhe MULTITEL_API_PASSWORD përmes konfigurimit sekret të serverit tuaj përpara se të përdorni shembujt. Mos i ngulitni kurrë në JavaScript publik të shfletuesit, në URL ose në kontrollin e burimit. Kredencialet e dedikuara menaxhohen te Cilësimet e Integrimit API.
Përgatitni një kërkesë SMS
Përdorni një numër dërgues të miratuar, të aftësuar për SMS dhe në pronësi të llogarisë, si dhe një marrës që ka pranuar të marrë mesazhin. Përfundoni regjistrimin e kërkuar Brand/Campaign ose verifikimin e numrit pa pagesë për telefonuesin. Shembulli më poshtë dërgon një mesazh të vërtetë kur plotësohet me kredenciale dhe numra funksionalë; ai nuk është një 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"Zëvendësoni vendmbajtësit e dërguesit dhe marrësit me numra telefoni në format ndërkombëtar, vetëm me shifra dhe duke përfshirë kodin e shtetit. Për MMS, jepni te media një URL medie të mbështetur dhe të aksesueshme publikisht, dhe verifikoni fillimisht pranueshmërinë dhe çmimin e MMS.
Pranimi nuk është shpërndarje
Inspektoni si statusin e jashtëm të aplikacionit, ashtu edhe rezultatin e kthyer të mesazheve. Regjistroni identifikuesin e mesazhit të dhënë nga shërbimi dhe ndiqni statusin e shpërndarjes dhe ngjarjet webhook. Një dërgim i suksesshëm nuk mund të provojë se aparati i marrësit e mori mesazhin.
Faturimi i SMS është për segment. Kodimi dhe gjatësia e mesazhit mund të prodhojnë disa segmente; tarifat e medias dhe ato të lidhura me operatorin mund të ndryshojnë nga SMS. Lexoni çmimin aktual të shitjes së llogarisë përpara dërgimit. Mos riprovoni kurrë verbërisht një dërgim me skadim kohe: inspektoni fillimisht rezultatin e tij të regjistruar.
Trajtoni gabimet dhe riprovat
- Dështim vërtetimi ose lejimi
- Kontrolloni gjendjen e aktivizimit të kredencialit API, shërbimin e lejuar dhe kufizimin e IP-së burim. Një cookie sesioni portali nuk është kredencial integrimi.
- Kredi e pamjaftueshme ose miratim i paplotësuar
- Zgjidhni problemin me bilancin e llogarisë, miratimin e dërgimit ose kërkesën për dokumente përpara se të përsërisni operacionin.
- Asnjë rezultat
- Trajtojeni inventarin bosh ose mungesën e emrit të telefonuesit si një rezultat të zakonshëm. Mos supozoni se një numër sintaksisht i vlefshëm i ka të gjitha shërbimet.
- Skadim kohe i rrjetit ose dështim shërbimi
- Përdorni riprova të kufizuara me pritje rritëse për leximet. Për një blerje, dërgim ose regjistrim, inspektoni fillimisht gjendjen e operacionit; riprovimi i një kërkese të pranuar mund të dyfishojë një veprim të faturueshëm.
Mbështetja e idempotencës i përket secilës familje API. Emergency API mbështet çelësat e riprovës; kjo nuk i bën kërkesat arbitrare v3 idempotente. Mbani vulat kohore, ID-të e kthyera dhe përgjigjet me të dhënat e ndjeshme të hequra për mbështetjen.
Vazhdoni me referencën e llogarisë suaj
Referenca pas hyrjes në llogari i filtron operacionet sipas lejeve tuaja dhe shërbimeve të aktivizuara. Përdorni hostin e saktë, llojin e kredencialeve, fushat e kërkesës dhe skemën e përgjigjes që tregon ajo. Konsolat mund të ekzekutojnë operacione reale, përfshirë blerje dhe mesazhe.