Geliştirici
SMS: Özel HTTP API
Listede olmayan bir SMS sağlayıcısını HTTP API ile bağlama: gövde şablonu, değişkenler, başlıklar, başarı ölçütü ve örnekler.
2 dk okumaGüncelleme: 21 Eylül 2026v2026.09
HTTP ile SMS gönderebilen herhangi bir servisi (Jetsms, Postagüvercini, Vatansms, Mobildev vb.) Özel HTTP API sağlayıcısıyla bağlayabilirsiniz. PlusTurk her mesaj için sizin tanımladığınız adrese, sizin tanımladığınız gövdeyle bir istek gönderir.
Alanlar#
| Alan | Açıklama | Varsayılan |
|---|---|---|
| API adresi | Servisin gönderme adresi; yalnızca https | — |
| Yöntem | POST ya da GET | POST |
| İçerik türü | json ya da form | json |
| Gövde şablonu | İsteğin gövdesi; değişkenler {{…}} ile yazılır | — |
| Başlıklar | Her satır Ad: değer (örn. Authorization: Bearer …); şifreli saklanır | boş |
| Başarı için yanıtta geçmesi gereken metin | Doluysa yanıtta bu metin aranır; yoksa HTTP 2xx başarıdır | boş |
| Gönderici başlığı | {{sender}} olarak şablona girer | — |
Şablon değişkenleri#
| Değişken | Değer | Örnek |
|---|---|---|
{{to}} | Alıcı, uluslararası biçimde | 905321234567 |
{{to_national}} | Alıcı, ulusal biçimde | 5321234567 |
{{message}} | Mesaj metni | Sayın Ayşe Yılmaz… |
{{sender}} | Gönderici başlığı | PLUSTURK |
Örnekler#
1{2 "to": "{{to}}",3 "text": "{{message}}",4 "from": "{{sender}}"5}GET seçildiğinde şablon sorgu dizesi olarak adrese eklenir (adreste ? varsa & ile).
Authorization: Bearer sk_live_xxxxxxxxX-Api-Version: 2Başarı ölçütü#
Bazı servisler hata durumunda da 200 OK döner. Böyle bir servisle çalışıyorsanız yanıtta başarıyı gösteren bir metin belirleyin:
| Servis yanıtı | Başarı için yanıtta geçmesi gereken metin |
|---|---|
{"status":"ok","id":123} | "status":"ok" |
OK 4589231 | OK |
<result>0</result> | <result>0</result> |
Alan boşsa HTTP durum kodu 2xx ise gönderim başarılı sayılır. Başarısız olursa yanıtın ilk 120 karakteri hata olarak gösterilir.
Servisi önce elle deneyin#
Sağlayıcı belgesindeki örneği önce curl ile deneyin; çalışan isteği şablona çevirmek kolaydır:
curl -X POST "https://api.ornek.com/sms/send" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"to":"905321234567","text":"Deneme","from":"PLUSTURK"}'Güvenlik sınırları#
Sık hatalar#
| Hata | Sebep ve çözüm |
|---|---|
Yalnızca https adreslerine bağlanılabilir | Adres http:// ile başlıyor; https kullanın |
Bu adrese bağlanılamaz | Adres iç ağa ya da geçersiz bir IP'ye çözülüyor |
Sağlayıcı yanıtı: HTTP 401 … | Başlıklardaki anahtar/şifre hatalı |
Sağlayıcı yanıtı: HTTP 200 … ama SMS gitmedi | Servis hatayı 200 ile döndürüyor; başarı ölçütü tanımlayın |