Mobildev API & SDK — Geliştirici SSS
Bu sayfa, Mobildev platformunu kendi sistemlerinize (CRM, ERP, e-ticaret, mobil uygulama) entegre eden geliştirici ve mühendislik ekipleri için hazırlanmıştır.
Genel Mimarı
Mobildev API'sine nasıl erişebilirim, dokümantasyon nerede?
REST API üzerinden erişim sağlanır; tüm endpoint'ler, istek/yanıt örnekleri ve kimlik doğrulama akışları postman.mobildev.com üzerindeki Postman koleksiyonunda ve geliştirici dokümantasyonunda yer alır.
Kimlik doğrulama (authentication) nasıl yapılıyor?
API istekleri, hesabınıza özel API anahtarı (API key) veya token tabanlı kimlik doğrulama ile yetkilendirilir. Anahtarlarınızı panel üzerinden oluşturabilir, rotasyon (yenileme) işlemini güvenlik politikanıza göre periyodik olarak yapabilirsiniz.
Hangi programlama dilleri için SDK/client kütüphanesi mevcut?
Python, Java ve Node.js başta olmak üzere yaygın kullanılan diller için hazır SDK ve client kütüphaneleri sunulur; bu kütüphaneler, ham HTTP isteği yazmak yerine doğrudan fonksiyon çağrısıyla entegrasyon yapmanızı sağlar.
Test Ortamı (Sandbox) & Canlıya Geçiş
Canlı ortama geçmeden test yapabileceğim bir sandbox var mı?
Evet; sandbox ortamı, gerçek SMS/e-posta gönderimi yapmadan (veya gerçek operatöre düşmeden) tüm API akışlarını, hata senaryolarını ve webhook tetiklemelerini güvenle simüle etmenizi sağlar. Üretim anahtarlarınızla sandbox anahtarlarınız birbirinden ayrıdır.
Sandbox'tan production'a geçişte ek bir onay süreci var mı?
Evet, yüksek hacimli gönderim yapacak entegrasyonlar için canlıya geçiş öncesi temel bir teknik doğrulama (rate limit, hata yönetimi, webhook güvenilirliği) önerilir; bu, canlı ortamda beklenmeyen hata oranlarının önüne geçer.
Webhook & Gerçek Zamanlı İzleme
Mesaj durumunu (iletildi, başarısız, okundu) nasıl takip ederim — sürekli API'yi sorgulamam mı gerekiyor?
Hayır; webhook/callback altyapısı sayesinde, bir mesajın durumu değiştiğinde (iletildi, başarısız, alıcı yanıtladı vb.) sisteminize otomatik bir bildirim (event) gönderilir. Bu, sürekli "polling" yapmanızı gerektirmeyen, kaynak verimliliği yüksek bir mimaridir.
Webhook isteğim başarısız olursa (sunucumuz o an erişilemezse) bildirim kaybolur mu?
Webhook teslimatı, geçici hatalarda (sunucu zaman aşımı, 5xx yanıtı gibi) tanımlı bir yeniden deneme (retry) politikasıyla tekrar denenir; bu, geçici bir kesinti sırasında olay bildirimlerinin sessizce kaybolmasını önler.
API kullanımımı, mesaj teslim oranlarımı ve izin durumlarımı tek bir yerden izleyebilir miyim?
Evet; geliştirici paneli/dashboard üzerinden API çağrı hacmi, hata oranları, mesaj teslim performansı ve (İVT entegrasyonu aktifse) izin durumu özetini tek ekrandan takip edebilirsiniz.
Entegrasyon & Güvenlik
CRM/ERP gibi sistemlerle entegrasyon ne kadar karmaşık, özel geliştirme ekibi mi gerekiyor?
REST API standart bir HTTP/JSON arayüzü sunduğundan, mevcut CRM/ERP/pazarlama otomasyon araçlarınızdaki "webhook" veya "custom entegrasyon" modülleri üzerinden orta düzey bir geliştirme efor ile bağlanabilir; yaygın CRM/ERP platformları için hazır entegrasyon rehberleri dokümantasyonda yer alır.
API trafiği ve mesaj içerikleri için güvenlik/şifreleme yaklaşımınız nedir?
Tüm API trafiği HTTPS üzerinden şifrelenmiş şekilde taşınır; hassas veri içeren entegrasyonlarda (örneğin OTP/finansal bildirim) uçtan uca şifreleme ve KVKK uyumlu veri saklama politikaları uygulanır.
Rate limit (istek sınırı) nedir, yüksek hacimli bir entegrasyonda bu sınıra nasıl çarpmayız?
API, kötüye kullanımı önlemek için zaman bazlı istek sınırları (rate limit) uygular; yüksek hacimli entegrasyonlar için bu limitler, beklenen trafiğiniz önceden bildirildiğinde hesap yöneticinizle birlikte özel olarak yapılandırılabilir.
Neden Mobildev? (API/SDK için Proaktif Sorular)
API üzerinden gönderdiğim bir SMS'in izin durumu kontrolü otomatik mi yapılıyor, yoksa bunu ayrıca ben mi kontrol etmeliyim?
İVT entegrasyonu aktifse, API üzerinden yapılan gönderim isteği, gönderim öncesi izin durumunu otomatik kontrol edebilir; bu, "API her zaman gönderir, izin kontrolü tamamen geliştiricinin sorumluluğundadır" modelinden farklı olarak, uyum katmanını entegrasyonun bir parçası haline getirir.
API dokümantasyonu güncel mi tutuluyor, yoksa üretimdeki davranışla dokümantasyon arasında fark olabiliyor mu?
Dokümantasyon ve Postman koleksiyonu, API sürüm değişiklikleriyle eş zamanlı güncellenir; versiyon bazlı değişiklik günlüğü (changelog) ile hangi endpoint'in ne zaman değiştiği takip edilebilir, bu da geriye dönük uyumluluk (backward compatibility) planlamanızı kolaylaştırır.
Rakip API'ler genellikle hangi noktada geliştirici deneyimini zorlaştırıyor?
Çoğu sağlayıcı sandbox ortamı sunmaz veya sandbox'ı production'dan ayrıştırmaz; bu, geliştiricilerin test sırasında yanlışlıkla gerçek mesaj/maliyet oluşturma riskiyle karşı karşıya kalmasına yol açar. Ayrıca webhook retry politikası belirsiz olan sağlayıcılarda, geçici ağ sorunlarında olay bildirimleri sessizce kaybolabilir.