Englishİlk mesajınızı gönderin bir öğleden sonra
SMS göndermek, izlemek ve almak için basit bir REST API — belirteç kimlik doğrulaması, gerçek zamanlı web kancaları ve SDK'lar; öğrenilecek egzotik hiçbir şey yok.
Üç hamle, teslim edilmeye başlandı
Her entegrasyon aynı kısa yaydan oluşur; kimlik doğrulama, gönderme ve takip etme.
Erişim anahtarınızı her istekte Content-Type: application/json ile Token başlığı olarak gönderin.
Gönderen, gönderen ve içerik POST. Yanıt hemen bir msgid ve bir hata koduyla birlikte gelir.
Bir mesaj son durumuna ulaştığı anda geri arama URL'nize bir durum raporu POST Ediyoruz veya Alıyoruz.
Halihazırda kullandığınız dilde bir istek
Göndericinizi, alıcınızı ve içeriğinizi bir Token başlığıyla POST yapın. Yanıt, kabul ettiğimiz anda geri gelir.
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 }'msgstr "9f2a7c10-4b2e-..."
yön "mt"
hata kodu 0
Kaydet msgstr - bu mesajı buradan takip etme şekliniz budur.
Bir mesajı yukarıdan aşağıya okuyun
Gönderme, durum ve gelen olayların tümü aynı şekli döndürür; bunu bir kez öğrenin.
Mesaj Kimliği
msgstr — bir mesajın oluşturulduğu anda basılır. Bu daha sonra durumunu kontrol etmek için kullanacağınız tanıtıcıdır.
Gönderen
alıcılarınızın gördüğü kimlik ne olursa olsun, bir telefon numarası veya 11 karaktere kadar alfasayısal bir kimlik.
Alıcı
Kime — ülke kodu da dahil olmak üzere mesajın gideceği numara.
Kodlama
veri kodlama — GSM7 parça başına 160 karaktere sığar; Unicode'a geçin ve bu 70'e düşer. Devam edin ve ekstra faturalandırılmış parçalara birleştirilir.
Yön
yön — her mesaj mt (gönderdiğiniz) veya mo (aldığınız) şeklindedir, her iki durumda da aynı şekildir.
Hata Kodu
hata kodu — gönderme yanıtında ve her durum raporunda döndürülür. 0 kabul edildiği anlamına gelir; başka herhangi bir şey size tam olarak neyin yanlış gittiğini söyler.
Bir uç nokta, iki fiil
Göndermek için POST, durumu kontrol etmek için GET — her iki durumda da aynı URL ve aynı Token başlığı.
Göndermek
Bir mesaj gönderin ve hemen bir mesaj ve hata kodu alın.
İade msgstr + hata koduİzlemek
Mevcut durumunu kontrol etmek için daha önce göndermiş olduğunuz bir mesaja bakın.
İade mesaj + durumDurum raporları, gerçekleştiği anda
Bir geri arama URL'si belirlediğinizde her teslimat, hata ve gelen yanıt oraya GET veya POST olarak ulaşır; yoklama gerekmez.
API anahtarınızı alın
REST API'miz ile dakikalar içinde entegrasyona başlayın.
Geliştirici belgeleri — sık sorulan sorular
Erişim anahtarınızı her istekte bir Token başlığına (Token: {accessKey}) ve Content-Type: application/json'a iletin.
Her gönderim bir msgid döndürür. Bizi bir geri arama URL'sine yönlendirin ve mesaj son durumuna (alt tarih, bağış tarihi ve sonuçta ortaya çıkan durum kodu dahil) ulaştığı anda ona bir durum raporu POST veya ALIN.
mt (mobil sonlandırıldı) gönderdiğiniz bir mesajdır; mo (mobil kaynaklı) aldığınız bir yanıttır. Her ikisi de aynı mesaj nesnesi şeklini kullanır.
Teslimat, yeniden deneme ilkesine göre yeniden denenir; hiçbir şey sessizce düşürülmez, ancak hiçbir zaman onaylamayan bir uç nokta, yeniden denemeler almaya devam eder.
GSM7 kodlamasında 160 karakter veya Unicode'da 70 karakter. Sınırı aştığınızda mesaj, her biri ayrı olarak faturalandırılan birden çok parça halinde birleştirilir.