EnglishSkicka ditt första meddelande på en eftermiddag
Ett enkelt REST-API för att skicka, spåra och ta emot SMS — token-auth, realtidswebhooks och SDK:er, utan något exotiskt att lära sig.
Tre drag, börjar levereras
Varje integration är samma korta båge – autentisera, skicka och spåra sedan.
Skicka din åtkomstnyckel som ett Token-huvud, med Content-Type: application/json, på varje begäran.
LÄGGA upp ett från, till och innehåll. Svaret kommer tillbaka med ett msgid och en felkod omedelbart.
Vi POST eller HEM en statusrapport till din återuppringnings-URL i samma ögonblick som ett meddelande når sitt slutliga tillstånd.
En begäran, på det språk du redan använder
POSTA din avsändare, mottagare och innehåll med ett Token-huvud. Svaret kommer tillbaka när vi accepterar det.
01curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \02 -H "Token: $SMSLOCAL_TOKEN" \03 -H "Content-Type: application/json" \04 -d '{05 "from": "SMSLOCAL",06 "to": "14155550123",07 "content": "Your code is 481920."08 }'msgid "9f2a7c10-4b2e-..."
riktning "mt"
felkod 0
Spara msgid – det är hur du spårar det här meddelandet härifrån.
Läs ett meddelande uppifrån och ned
Skicka, status och inkommande händelser returnerar alla samma form – lär dig det en gång.
Meddelande-ID
msgstr — skrivs i samma ögonblick som ett meddelande skapas. Detta är handtaget du använder för att kontrollera dess status senare.
Avsändare
från — ett telefonnummer eller ett alfanumeriskt ID upp till 11 tecken, vilken identitet dina mottagare än ser.
Mottagare
till — numret som meddelandet går till, inklusive landskod.
Kodning
datakodning — GSM7 rymmer 160 tecken per del; byta till Unicode och det sjunker till 70. Gå över, och det sammanfogas till extra fakturerade delar.
Riktning
riktning — varje meddelande är mt (du skickade det) eller mo (du fick det), samma form åt båda hållen.
Felkod
felkod — returneras på sändningssvaret och varje statusrapport. 0 betyder accepterad; allt annat säger dig exakt vad som gick fel.
En slutpunkt, två verb
POST för att skicka, GET för att kontrollera status — samma URL och samma Token-rubrik oavsett.
Skicka
Skicka ett meddelande och få tillbaka ett msgid och en felkod omedelbart.
Returnerar msgid + felkodSpåra
Slå upp ett meddelande som du redan har skickat för att kontrollera dess aktuella status.
Returnerar meddelande + statusStatusrapporter, i det ögonblick de inträffar
Ange en återuppringnings-URL och varje leverans, misslyckande och inkommande svar hamnar där som en GET eller POST – ingen polling krävs.
Utvecklardokument – vanliga frågor
Skicka din åtkomstnyckel i ett Token-huvud på varje begäran — Token: {accessKey} — tillsammans med Content-Type: application/json.
Varje sändning returnerar ett msgid. Rikta oss på en återuppringnings-URL och vi POSTAR eller HÄMTAR en statusrapport till den så fort meddelandet når sitt slutliga tillstånd - underdatum, färdigdatum och den resulterande statuskoden ingår.
mt (mobil terminated) är ett meddelande du skickat; mo (mobil ursprung) är ett svar du fått. Båda använder samma meddelandeobjektform.
Leveransen görs om enligt policyn om försök igen – ingenting släpps tyst, men en slutpunkt som aldrig erkänner kommer att fortsätta att ta emot återförsök.
160 tecken på GSM7-kodning, eller 70 på Unicode. Gå förbi gränsen och meddelandet sammanfogas i flera delar, var och en faktureras separat.