1. API Dili Seçimi
🌐 Giriş gerektirmeyen API uç noktalarındaAccept-Language başlığını kullanarak yanıtların çevirisini seçebilirsiniz. Favori dilinizi otomasyonlarınıza takın ve aşağıdaki seçeneklerden birini belirtin. 🎯
Giriş gerektirmeyen API uç noktaları 🔓
- Yetkilendirme Servisi ⚙️
- Yeni Kullanıcı Kaydı -
/v1/auth/register - Giriş İşlemi -
/v1/auth/login - Erişim Belirteci Yenileme -
/v1/auth/refresh
- Yeni Kullanıcı Kaydı -
- Kullanıcı Servisi 👥
- Şifre Sıfırlama İsteği
/v1/users/password-reset-request
- Şifre Sıfırlama İsteği
Kullanıcı Dil Seçimi
Kullanıcı giriş yaptıktan sonra gönderilen Erişim Belirteci içindeki dil ve yerel ayar bilgisi otomatik olarak okunur, böylece yanıtlar doğru dile çevrilir. Ayrıca/v1/users/update uç noktasındaki Kullanıcı Güncelleme İşlemi ile kullanıcı (ADMIN ise diğer kullanıcılar için de) dil, yerel ve zaman dilimi ayarlarını rahatça güncelleyebilir. 🛠️🌎
2. Kullanıcı Kaydı ve Hesap Aktivasyonu
1
Yeni Kullanıcı Kaydı
- Yeni Kullanıcı Kaydı -
/v1/auth/registerAPI uç noktası üzerinden aşağıdaki bilgiler girilerek yeni bir kullanıcı kaydı oluşturulur:- Kullanıcı adı (e-posta adresi)
- Şifre
- Adı
- Varsa Göbek Adı
- Soyadı
- Dil ve Yerel Ayarlar Tercihi
- Zaman Dilimi Tercihi
- Kayıt sırasında aynı kullanıcı adına (e-posta) sahip bir kayıt varsa,
400 - Hatalı İstekkodu veKullanıcı Mevcutmesajı döner. 🚫 - İşlem başarılıysa kullanıcı durumu
INACTIVEolarak oluşturulur ve aktivasyon beklenir. ⏳
2
Hesap Aktivasyon İsteği
- Hesap Aktivasyon İsteği -
/v1/accounts/account-activation-requestAPI uç noktasına aşağıdaki bilgiler gönderilerek bir hesap aktivasyon talebi oluşturulur:- Kullanıcı ID
- Hesap Tipi
- Mobil Telefon Numarası
- Konum Adresi
- Firma
- Endüstri
- Hesap Aktivasyon Sayfası Linki
- Uç nokta; kullanıcının mevcut hesabı olup olmadığını doğrular, geçerliyse hesabı oluşturur ve aktivasyon bağlantısını içeren bir e-postayı kullanıcıya gönderir. ✉️
3
Hesap Aktivasyonu
- Hesap Aktivasyonu -
/v1/accounts/activate-accountAPI uç noktası üzerinden aşağıdaki bilgiler girilerek yeni bir hesap kaydı neticelendirilir:- Kullanıcı ID
- Hesap ID
- E-posta Doğrulama Belirteci
- Sağlanan e-posta doğrulama belirtecini kontrol ederek kullanıcı hesabını etkinleştirir, hesap ve kullanıcı durumlarını günceller ve belirtecin süresinin dolmadığını doğrular. 🔐
- Doğrulandıktan sonra, hesap e-postası doğrulandı olarak işaretlenir ve belirteç alanları temizlenir. ✅
4
Mobil Telefon Numarası Doğrulama İsteği
- Telefon Numarası Aktivasyon Talebi -
/v1/accounts/phone-number-activation-requestAPI uç noktası üzerinden aşağıdaki bilgiler girilerek telefon numarası doğrulama isteği yapılır:- Kullanıcı ID
- Hesap ID
- Telefon Numarası Aktivasyon Sayfası Linki
- Bir kullanıcının telefon numarası için aktivasyon sürecini yönetir. Bu, hesabın doğrulanmasını, bir telefon numarası doğrulama belirteci oluşturulmasını, bir aktivasyon mesajı oluşturulmasını ve aktivasyon SMS’inin gönderilmesini içerir. 📲
- İsteğe bağlıdır; bu adım atlanırsa SMS bildirimleri gönderilemez. 📵
5
Mobil Telefon Numarası Doğrulaması
- Telefon Numarası Aktivasyonu -
/v1/accounts/activate-phone-numberAPI uç noktası üzerinden aşağıdaki bilgiler girilerek telefon numarası doğrulama işlemi tamamlanır:- Kullanıcı ID
- Hesap ID
- Telefon Numarası Doğrulama Belirteci
- Uç nokta, hesapla ilişkili doğrulama belirtecini kontrol ederek telefon numarasını etkinleştirir. 🔁
6
Abonelik Seçimi
Kullanıcı abonelik seçmeden ücretli servisleri kullanamaz; bu nedenle bir sonraki adımı hızlıca tamamlayın. 💡
3. Abonelik İşlemleri
- Abonelik Güncelleme -
/v1/accounts/update-subscriptionAPI uç noktası üzerinden aşağıdaki bilgiler girilerek kullanıcı için abonelik güncellemesi yapılır:- Plan Seçimi
- Kullanıcı ID
- Abone ID
- Abonelik Planı İsmi
- Özel Plan Oluşturma
- Kullanıcı ID
- Abone ID
- Plan Detayları
- Abonelik Süresi
- Limit Sıfırlama Periyodu
- Coğrafi Sınır
- API Servis Limitleri
- API Versiyonu
- API Endpoint İsmi
- Maksimum Çağrı Sayısı
- Plan Seçimi
- Bu uç nokta gerekli rol ve hesap kontrollerini yapar, abonelik planını günceller, gerekiyorsa kullanıcı durumunu değiştirir ve doğrulama hatası varsa anlaşılır mesajlar döndürür. ✅📬
3.1. Abonelik Planları 📦
| Plan | Süre | Limit Profili | Coğrafi Kapsam | Kısa Not |
|---|---|---|---|---|
Hiçbiri | - | Limit uygulanmaz | Uygulanmaz | Aboneliği olmayan veya iptal edilen kullanıcıların varsayılan durumu. |
Deneme | 1 ay | Günlük 5 çağrı limiti, çok düşük hacim | Tüm bölgeler | Kullanıcı başına tek seferlik deneme; değerlendirme amaçlı. |
Giriş Seviyesi - Aylık | 1 ay | Aylık sıfırlama, limit sayısı 1, kısıtlı çağrı hakkı | Tüm bölgeler | Ekonomik opsiyon; her ay yenilenerek kullanılır. |
Giriş Seviyesi - Yıllık | 1 yıl | Yıllık kota, sınırlı toplam çağrı | Tüm bölgeler | 1 yıl boyunca esnek şekilde harcanabilen ekonomik paket. |
Premium - Aylık | 1 ay | Aylık sıfırlama, yüksek allowance | Tüm bölgeler | Üst seviye aylık erişim; ay sonunda yenileyin. |
Premium - Yıllık | 1 yıl | Yıllık kota, geniş limitler | Tüm bölgeler | Premium yıllık paket; geniş kotayı yıl boyunca kullanın. |
Özel | Tercihe göre | Süre, limit tipi ve çağrı sayısı ayarlanabilir | Ülke/bölge sınırları yapılandırılabilir | Tüm parametreleri müşteri sözleşmesine göre uyarlayabileceğiniz esnek plan. |
3.2. Özel Abonelik Seçeneği İçin Coğrafi Sınır Seçenekleri 🗺️
- Türkiye
- Avrupa
- Asya
- Dünya
- Tümü
- Akdeniz Bölgesi
- Doğu Anadolu Bölgesi
- Ege Bölgesi
- Güneydoğu Anadolu Bölgesi
- İç Anadolu Bölgesi
- Marmara Bölgesi
- Karadeniz Bölgesi