API

Kendi botunuzu ya da panelinizi yazıyorsanız numaraları API üzerinden alabilirsiniz.

Kimlik doğrulama

Anahtarınızı hesap sayfanızdan üretin ve her istekte başlık olarak gönderin. İki biçim de kabul ediliyor:

Authorization: Bearer ANAHTARINIZ
X-Api-Key: ANAHTARINIZ

Anahtarı adres çubuğunda (sorgu dizesinde) göndermeyin — oradaki değer sunucu erişim günlüklerine yazılıyor.

Uçlar

GET /api/v1/bakiye Hesap bakiyesi

GET /api/v1/fiyatlar Ülke ve servise göre fiyat, stok ve teslim oranı

POST /api/v1/al Numara satın alır

GET /api/v1/siparis/{id} Sipariş durumu ve gelen SMS

POST /api/v1/siparis/{id}/iptal İptal eder, ücreti iade eder

POST /api/v1/siparis/{id}/bitir Siparişi tamamlar, numarayı serbest bırakır

Örnek

# Bakiye
curl -H "Authorization: Bearer ANAHTARINIZ" \
     https://iyisms.com/api/v1/bakiye

# Telegram / Litvanya fiyatlari
curl -H "Authorization: Bearer ANAHTARINIZ" \
     "https://iyisms.com/api/v1/fiyatlar?urun=telegram&ulke=lithuania"

# Numara al
curl -X POST -H "Authorization: Bearer ANAHTARINIZ" \
     -d "urun=telegram&ulke=lithuania" \
     https://iyisms.com/api/v1/al

# Kod geldi mi
curl -H "Authorization: Bearer ANAHTARINIZ" \
     https://iyisms.com/api/v1/siparis/123

Yanıt biçimi

Bütün uçlar aynı zarfı döndürüyor. Başarıda ok true ve veri veri içinde; hatada hata.kod makine, hata.mesaj insan içindir. HTTP durum kodu da anlamlı: 401 anahtar, 402 bakiye, 409 çakışma, 429 hız sınırı, 503 geçici.

{ "ok": true, "veri": { "id": 123, "numara": "+37060000000", "kod": null } }

{ "ok": false, "hata": { "kod": "yetersiz_bakiye", "mesaj": "Bakiye yetersiz." } }

Hız sınırı

Dakikada 60 istek. Sınıra takılan istek 429 döner ve Retry-After başlığı bekleme süresini söyler. Kalan hakkınız her yanıtta X-RateLimit-Remaining başlığında.

Anahtar hesap başına tek. Yenilediğinizde ya da sildiğinizde eski anahtar anında geçersiz olur — çalışan bir entegrasyonunuz varsa durur. API ile yapılan alımlar sitedekiyle aynı kurallara tabidir: aynı servis için aynı anda ikinci sipariş açılamaz ve bakiye yetmiyorsa işlem yapılmaz.