API erişimi nasıl alınır?
Onremo'nun REST API'si, hesabınızdaki sistemlere programatik erişim sağlar. Kullanıcı yönetimi, sistem listesi, fatura sorgulama gibi işlemler için kullanabilirsiniz.
API erişimi Pro ve üzeri planlarda mevcuttur. Free planda salt-okunur 100 istek/saat limit ile ücretsiz dener hakkı vardır.
API çağrıları iki farklı yolla yapılabilir: API Anahtarı (sunucu-arası) ya da OAuth 2.0 (3. parti uygulamalar). Hangisini seçeceğiniz kullanım senaryonuza bağlı.
Adım adım rehber
1. Hesap → Geliştirici'ye gidin
Sağ üst avatar → Hesap → sol nav'da en altta Geliştirici sekmesi (Pro plan üyelerine görünür).
2. API anahtarı oluştur
“+ Yeni API anahtarı”'ne tıklayın. Bir isim girin (örn. “Production server”), kapsamları seçin (read:systems, write:users, vb.). Anahtar oluşturulduğunda bir kez gösterilir; not edin (geri görüntüleyemezsiniz).
3. OAuth uygulaması (3. parti için)
Eğer kullanıcı adına başka bir uygulamadan giriş istiyorsanız: “+ OAuth uygulaması” ile redirect URL ve client_id alın.
4. İlk isteği yapın
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.onremo.app/v1/systems5. Rate limit'leri anlayın
Pro plan: 1.000 istek/dakika, 100.000 istek/gün. Limit aşıldığında 429 hata kodu döner. X-RateLimit-Remaining header'ını takip edin.
6. Webhook kurulumu
Olay-bazlı bildirimler için Geliştirici → Webhooks ile kendi URL'inizi kaydedin. system.purchased, user.invited gibi 30+ olay tipini destekler.
İpuçları ve sık karşılaşılan durumlar
Mobil uygulama ya da JavaScript'te API anahtarını gömülü tutmayın — bu derhal sızdırma demektir. OAuth flow kullanın.
Geliştirme için https://api-sandbox.onremo.app kullanın. Sandbox'ta tüm veriler simüle edilir, gerçek faturalama olmaz.
Resmi SDK'lar: Node.js, Python, PHP, Ruby. Hepsi npm install @onremo/sdk gibi standart paket yöneticileriyle kurulur.
status.onremo.app'ı kontrol edin. API'de bir kesinti varsa burada listelenir.