Okul Toplu SMS API Entegrasyon Dökümantasyonu

Geliştirici

SMS API Nedir?

İlkSMS API'si, kendi programınızdan (okul yönetim yazılımı, e-Okul uyumu, mobil uygulama vb.) doğrudan toplu SMS ve OTP gönderimi yapmanızı sağlar. PHP, C#, Python, Java, ASP gibi tüm dillerden JSON POST isteğiyle kullanılır. Tüm servisler JSON formatında yanıt döner.

API kullanıcı adı ve şifreniz, hesap panelinizden (app.ilksms.com → API Ayarları) oluşturulur. Bu bilgiler hesap giriş şifrenizden farklıdır ve yalnızca API erişimi içindir.

Örnek İstek Gövdesi (JSON)

Tüm servislere HTTP POST ile, gövdede JSON göndererek istek yaparsınız. Örnek — okul numaralarına SMS:

POST https://app.ilksms.com/api/okulnosms
Content-Type: application/json

{
  "apiUsername": "API_KULLANICI_ADINIZ",
  "apiPassword": "API_SIFRENIZ",
  "baslik": "OKULUNUZ",
  "mesaj": "Sayın velimiz, bugün okulumuzda veli toplantısı vardır.",
  "veliTur": "12",
  "tur": "turkce",
  "okulNumaralari": "17,245,602"
}

Servisler (Endpoint'ler)

POST https://app.ilksms.com/api/okulnosms

Okul Numaralarına SMS

Öğrenci okul numaralarına, velilere toplu SMS gönderimi yapar. Yanıt: JSON

Parametre	Açıklama
`apiUsername`	Hesabınıza tanımlı API kullanıcı adı.
`apiPassword`	Hesabınıza tanımlı API şifresi.
`baslik`	SMS göndermek istediğiniz, hesabınıza tanımlı onaylı gönderici adı (başlık).
`mesaj`	Gönderilecek mesaj içeriği.
`veliTur`	Varsayılan "1". Kabul edilen değerler — "1": 1. veli, "2": 2. veli, "12": 1. ve 2. veli.
`tur`	Varsayılan "normal" (160 karakter). "turkce": Türkçe karakterli gönderim.
`okulNumaralari`	Okul numaraları virgülle ayrılarak gönderilir. Örnek: "17,245,602".
`rehberTur`	Varsayılan "0". Okul numarasıyla öğrenciye ulaşırken kullanılan sorgu tipi.
`tarih`	Opsiyonel. İleri tarihli gönderim için. Format: "30/01/2019".
`saat`	Opsiyonel. İleri saatli gönderim için. Format: "17:05".

POST https://app.ilksms.com/api/kullanicibilgi

Hesap Bilgisi

Hesabınızın kalan kredi/kontör ve tanım bilgilerini sorgular. Yanıt: JSON

Parametre	Açıklama
`apiUsername`	Hesabınıza tanımlı API kullanıcı adı.
`apiPassword`	Hesabınıza tanımlı API şifresi.

POST https://app.ilksms.com/api/ntonsms

N'e N SMS (Numaraya Özel Mesaj)

Her numaraya farklı (kişiselleştirilmiş) mesaj gönderimi yapar. Yanıt: JSON

Parametre	Açıklama
`apiUsername`	Hesabınıza tanımlı API kullanıcı adı.
`apiPassword`	Hesabınıza tanımlı API şifresi.
`baslik`	Hesabınıza tanımlı onaylı gönderici adı (başlık).
`tur`	Varsayılan "normal" (160 karakter). "turkce": Türkçe karakterli gönderim.
`telMesajlar`	JSON dizisi. Her eleman { "mesaj": "...", "telefon": "05xxxxxxxxx" } biçimindedir.
`tarih`	Opsiyonel. Format: "30/01/2019".
`saat`	Opsiyonel. Format: "17:05".

POST https://app.ilksms.com/api/gruplar

Grup / Sınıf Listesi

Hesabınıza tanımlı grup ve sınıf listesini döndürür. Yanıt: JSON

Parametre	Açıklama
`apiUsername`	Hesabınıza tanımlı API kullanıcı adı.
`apiPassword`	Hesabınıza tanımlı API şifresi.

API erişimi için önce ücretsiz üye olun. Üyelik sonrası panelden API kullanıcı adı/şifrenizi oluşturup entegrasyona başlayabilirsiniz.

Ücretsiz Üye Ol

SMS API Dökümantasyonu