Ticari elektronik ileti izinlerinizi tek bir REST API ile İYS'ye bağlayın. İzin ekleme, tekil ve toplu sorgulama, marka yetki kontrolü ve izin geçmişi — asenkron ve ölçeklenebilir altyapıyla.
İhtiyacınıza göre ölçeklenen paketler. Net fiyat için teklif alın.
Küçük işletmeler ve düşük hacimli izin yönetimi için.
Aktif kampanya yürüten orta ve büyük ölçekli firmalar için.
Yüksek hacimli ve özel entegrasyon ihtiyaçları için.
Selfiys API standart REST prensiplerine uyar. Tüm istekler HTTPS üzerinden yapılır;
istek ve yanıt gövdeleri JSON (UTF-8) formatındadır.
İzin işlemleri asenkron çalışır: istek bir guid ile kuyruğa alınır, sonuç ilgili
GET uç noktasından sorgulanır.
https://api.selfiys.com/api/v1
Rate limit 60 istek / dakika · İzin sorgu 1.000 istek / saat (IP başına)
api_key ve api_secret ile 1 saat geçerli bir Bearer token alın.
// İstek { "api_key": "f2ee2f9f-2c72-11f1-899d-52e18006e243", "api_secret": "899d11f12c7252e18006e243fd933061" } // Yanıt (200) { "token": "dfd767e0b6701f727d50ddf82978b7a4...", "expires_at": "2026-03-31 00:07:43" }
Sonraki tüm isteklerde başlık olarak gönderin:
Authorization: Bearer <token> Content-Type: application/json
Aktif token'a ait hesap bilgilerini döner. Entegrasyonu test etmek için idealdir.
Hesabınıza bir İYS firma kodu tanımlar. GET /api/v1/firma kayıtlı firmaları listeler.
// POST İstek { "iysFirmaKodu": "631866" } // Yanıt (201) { "message": "Firma basariyla eklendi", "id": 1 }
Markanızın İYS yetki durumunu ve API kayıt durumunu tek istekte kontrol eder.
{
"brandCode": 631866,
"iys": { "kayitli": true, "MESAJ": 1, "ARAMA": 1, "EPOSTA": 1 },
"api": { "kayitli": true, "markaAdi": "Ana Marka" }
}
Yeni bir izni (ONAY/RET) İYS'ye kaydeder. Asenkrondur; dönen guid ile GET /izin?guid= üzerinden takip edilir.
// İstek { "iysCode": 631866, "brandCode": 631866, "recipient": "+905333031510", "type": "MESAJ", "source": "HS_WEB", "status": "ONAY", "consentDate": "2026-03-30 12:00:00", "recipientType": "BIREYSEL" } // Yanıt (201) { "guid": "a1b2c3d4-...", "durum": "bekliyor" }
recipient telefon (+905XXXXXXXXX) veya e-posta olabilir. Ayrıca telefon ile listeleme: GET /izin?tel=5333031510
Tekil bir alıcının güncel izin durumunu sorgular. Sonuç GET /izin-sorgula?guid= ile alınır.
{
"iysCode": 631866,
"brandCode": 631866,
"recipient": "+905333031510",
"type": "MESAJ"
}
1–100 alıcı için detaylı izin bilgisi (kaynak, tarih, durum) sorgular. Her alıcı için ayrı guid döner.
{
"iysCode": 631866,
"brandCode": 631866,
"recipients": ["+905333031510", "+905441234567"],
"type": "MESAJ",
"recipientType": "BIREYSEL"
}
Bir alıcının tüm izin geçmişini (değişiklikleri) listeler. recipient gönderilmezse firma/marka için toplu geçmiş alınır. Sonuç GET /izin-gecmis?guid= ile alınır.
{
"iysCode": 631866,
"brandCode": 631866,
"recipient": "+905333031510",
"type": "MESAJ"
}
Kampanya öncesi 1.000 numaraya kadar izin durumunu tek istekte kontrol eder; kotayı optimize ederek yalnızca onaylıları döner.
{
"iysCode": 631866,
"brandCode": 631866,
"type": "MESAJ",
"recipients": ["+905333031510", "+905441234567"]
}
// Sonuç
{ "onayliSayisi": 2, "onaylilar": ["+905333031510", "+905441234567"] }
ARAMA MESAJ EPOSTA
ONAY RET
BIREYSEL (varsayılan) TACIR
HS_WEB HS_MESAJ HS_CAGRI_MERKEZI HS_SOSYAL_MEDYA HS_EPOSTA HS_MOBIL HS_FIZIKSEL_ORTAM HS_ISLAK_IMZA HS_EORTAM HS_ETKINLIK HS_ATM HS_2015 HS_KARAR
Hatalar { "error": "...", "code": "..." } biçiminde döner.
| HTTP | Kod | Anlamı |
|---|---|---|
| 400 | MISSING_CREDENTIALS | api_key veya api_secret eksik |
| 400 | MISSING_FIELD | Zorunlu alan eksik |
| 400 | VALIDATION_ERROR | Girdi doğrulaması başarısız |
| 401 | INVALID_CREDENTIALS | Geçersiz api_key / api_secret |
| 401 | AUTH_REQUIRED | Authorization başlığı yok |
| 401 | TOKEN_EXPIRED | Token süresi doldu / geçersiz |
| 403 | FIRMA_NOT_FOUND | iysCode hesaba kayıtlı değil |
| 403 | FIRMA_LIMIT_EXCEEDED | Firma ekleme limiti aşıldı |
| 404 | NOT_FOUND / BRAND_NOT_FOUND | Kayıt / marka bulunamadı |
| 502 | IYS_ERROR | İYS servis hatası |
| 503 | IYS_UNAVAILABLE / SERVICE_UNAVAILABLE | Servis geçici olarak kullanılamıyor |
POST /token ile bearer token edinin.
POST /firma ile İYS firma kodunuzu ekleyin.
GET /marka ile yetki durumunu kontrol edin.
POST /izin → GET /izin?guid= ile sonucu izleyin.
Test ortamı, api_key/secret ve teknik dokümantasyonun tamamına erişmek için bizimle iletişime geçin.