EnglishEen eenvoudige REST API voor SMS versturen
POST uw afzender, ontvanger en inhoud met een Token-header. Ontvang direct een bericht-ID en bezorgingsrapporten worden naar uw server gepusht.
Eén verzoek, één bericht
Authenticeer met uw toegangssleutel, POST het bericht en lees de msgid uit het antwoord. Druk op de knop om hem te zien draaien.
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/smsVoer het verzoek uit om het antwoord te zien.
Niets exotisch om te leren
Drie ideeën bestrijken de hele API, die duidelijk volgt REST conventies.
- Authenticatie
Token-authenticatie
Stuur uw toegangssleutel bij elk verzoek in een Token-header, met JSON in en JSON uit.
- Geen SDK vereist
- Werkt vanuit elke taal
- Bewaar de sleutel in een omgevingsvariabele
- Antwoord
Weet dat het geaccepteerd is
Elke verzending retourneert onmiddellijk een msgid en een foutcode.
- Bewaar het msgid in uw eigen record
- foutcode 0 betekent geaccepteerd
- Gebruik de msgid om rapporten later te matchen
- Antwoorden
Standaard tweerichtingsverkeer
Antwoorden komen binnen bij dezelfde terugbelactie, gemarkeerd als afkomstig van mobiel.
- Dezelfde berichtvorm als rapporten
- Geef de routebeschrijving uit elkaar met mt / ma
- Stuur antwoorden door naar uw ondersteuningstools
Bekijk wat er met elk bericht is gebeurd
Er wordt een statusrapport op uw account geplaatst terugbel-URL wanneer een bericht zijn eindstatus bereikt.
- 1Matchen op msgidElk rapport bevat de ID die u bij verzending heeft gekregen.
- 2Alleen definitieve statenU hoort over een bericht wanneer het is afgeleverd of is mislukt.
- 3Eén terugbel-URLHetzelfde eindpunt ontvangt rapporten en antwoorden.
9f2a7c10+1 415 ••• 0123Afgeleverdzojuist9f2a7c11+91 98••• 43210Afgeleverd3 seconden geleden9f2a7c12+44 7••• 123456In behandeling5 seconden geleden9f2a7c13+91 99••• 00012Mislukt9 s geleden
Bekijk hoe een bericht wordt geteld
Langere tekst en niet-Latijnse tekens veranderen in hoeveel delen een bericht wordt gefactureerd. Probeer je eigen bewoording, en zoek een getal op voordat je verzendt.
- Deel 146 / 160
Eén deel bevat 160 tekens in GSM7 of 70 in Unicode. Eén niet-GSM-teken, zoals een emoji of een Hindi-letter, schakelt het hele bericht over naar Unicode.
Stop met het handmatig aan elkaar lijmen van berichten
Versleep de scheidingslijn om te vergelijken.
- Berichten verzonden vanaf uw eigen code
- Voor elk bericht een rapport
- Antwoorden worden naar uw systeem gepusht
- Handmatige export en upload
- Geen idee of er een bericht is aangekomen
- Antwoorden belanden in iemands inbox
Een korte checklist vóór de lancering
Vink items af terwijl u bezig bent. Hier wordt niets opgeslagen.
SMS-API - veelgestelde vragen
Geef bij elk verzoek uw toegangssleutel door in een Token-header, samen met Content-Type: application/json.
Elke verzending retourneert een msgid. Wijs ons op een callback-URL en we plaatsen er een statusrapport op wanneer het bericht de definitieve status bereikt.
160 tekens bij GSM7-codering, of 70 bij Unicode. Langere berichten worden uit verschillende delen samengevoegd, die elk afzonderlijk worden gefactureerd.
Ja. Inkomende antwoorden worden afgeleverd op dezelfde terugbel-URL en gemarkeerd als afkomstig van mobiel.
Ja. Sms'jes naar Indiase nummers moeten een goedgekeurde entiteit, afzenderheader en sjabloon gebruiken. Ons team helpt u bij het registreren ervan tijdens de onboarding.
Verstuur uw eerste sms binnen enkele minuten
Maak een account aan, pak uw toegangssleutel en doe uw eerste aanvraag.