Ett vanligt REST API för skicka SMS
POSTA din avsändare, mottagare och innehåll med ett Token-huvud. Få ett meddelande-ID direkt och leveransrapporter skickas till din server.
En begäran, ett meddelande
Autentisera med din åtkomstnyckel, POST meddelandet och läs meddelandet från svaret. Tryck på knappen för att se den köra.
1curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \
2 -H "Token: $SMSLOCAL_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "from": "SMSLOCAL",
6 "to": "14155550123",
7 "content": "Your code is 481920."
8 }'
/external/smsKör begäran för att se svaret.
Inget exotiskt att lära sig
Tre idéer täcker hela API:et, som följer enkelt VILA konventioner.
- Autentisering
Token-autentisering
Skicka din åtkomstnyckel i ett Token-huvud vid varje begäran, med JSON in och JSON ut.
- Ingen SDK krävs
- Fungerar från vilket språk som helst
- Håll nyckeln i en miljövariabel
- Svar
Vet att det accepterades
Varje sändning returnerar ett msgid och en felkod omedelbart.
- Lagra msgid mot ditt eget register
- felkod 0 betyder accepterad
- Använd msgid för att matcha rapporter senare
- Svar
Tvåvägs som standard
Svar kommer vid samma återuppringning, markerade som mobilt ursprung.
- Samma meddelandeform som rapporter
- Särskilj vägbeskrivningen med mt/mån
- Skicka svar till dina supportverktyg
Se vad som hände med varje meddelande
En statusrapport skickas till din återuppringnings-URL när ett meddelande når sitt slutliga tillstånd.
- 1Matcha med msgidVarje rapport innehåller det ID du fick vid sändningstillfället.
- 2Endast sluttillståndDu hör om ett meddelande när det levereras eller har misslyckats.
- 3En återuppringnings-URLSamma endpoint tar emot rapporter och svar.
9f2a7c10+1 415 ••• 0123Levererasjust nu9f2a7c11+91 98••• 43210Levereras3 s sedan9f2a7c12+44 7••• 123456I avvaktan på5 s sedan9f2a7c13+91 99••• 00012Misslyckades9 s sedan
Se hur ett meddelande räknas
Längre text och icke-latinska tecken ändrar hur många delar ett meddelande faktureras som. Prova din egen formulering, och slå upp ett nummer innan du skickar.
- Del 146 / 160
En del rymmer 160 tecken i GSM7 eller 70 i Unicode. Ett icke-GSM-tecken, till exempel en emoji eller en hindi-bokstav, växlar hela meddelandet till Unicode.
Sluta limma ihop meddelanden för hand
Dra avdelaren för att jämföra.
- Meddelanden skickade från din egen kod
- En rapport för varje meddelande
- Svar skickas till ditt system
- Manuell export och uppladdning
- Ingen aning om ett meddelande kom
- Svar landar i någons inkorg
En kort checklista före lansering
Kryssa för objekt när du går. Inget här är sparat.
SMS API — vanliga frågor
Skicka din åtkomstnyckel i ett Token-huvud på varje begäran, tillsammans med Content-Type: application/json.
Varje sändning returnerar ett msgid. Rikta oss på en återuppringnings-URL så skickar vi en statusrapport till den när meddelandet når sitt slutliga tillstånd.
160 tecken på GSM7-kodning, eller 70 på Unicode. Längre meddelanden sammanfogas från flera delar, var och en faktureras separat.
Ja. Inkommande svar levereras till samma återuppringningsadress och markeras som mobilt ursprung.
Ja. SMS till indiska nummer måste använda en godkänd enhet, avsändarhuvud och mall. Vårt team hjälper dig att registrera dem under onboarding.
Skicka ditt första SMS på några minuter
Skapa ett konto, ta din åtkomstnyckel och gör din första begäran.