OvoCRM’i kendi sisteminize bağlayın.
Standart REST arayüzü: istekler JSON döner, HTTPS zorunludur. Firma, kişi, fırsat, teklif, sipariş, fatura, sevkiyat, ürün ve hesap verilerinizi programatik olarak okuyun — yetkiniz varsa yazın. API anahtarınızı OvoCRM tanımlar, kapsamını birlikte belirleriz.
Bugün kullanabileceğiniz özellikler
- ✓REST API — x-api-key ile kimlik doğrulama
- ✓Kapsam bazlı yetki (kaynak:işlem)
- ✓10 kaynak: firma, kişi, fırsat, teklif, sipariş, fatura, sevkiyat, ürün, banka, kasa
- ✓Anahtar başına hız sınırı
- ✓Giden webhook — olaylar HMAC-SHA256 imzalı (G752: kod + uygulama ekranı canlıda doğrulandı, 10 Eki 2026)
10 Kaynak, Tek Arayüz
Firma, kişi, fırsat, teklif, sipariş, fatura, sevkiyat, ürün, banka ve kasa hesapları — hepsi aynı REST düzeninde.
Kapsam Bazlı Yetki
Anahtarınız yalnız verilen kapsamlarda çalışır: companies:read, invoices:export gibi. Fazlası 403 döner.
Hesabınıza Kapalı
Yalnızca kendi hesabınızın verisine erişirsiniz; başka firmaların verisi görünmez. Tüm trafik HTTPS.
Tüm Özellikler
Nasıl Çalışır?
4 adımda hazır.
Anahtar isteyin
OvoCRM ile iletişime geçin; hangi kaynaklara hangi işlemler için erişeceğinizi konuşalım.
Kapsamlar tanımlansın
Anahtarınıza yalnız ihtiyacınız olan kapsamlar verilir — örn. sadece okuma.
İlk isteği gönderin
curl ile GET /companies?limit=20 — başlıkta x-api-key ile.
Sisteminize bağlayın
Yanıtlar JSON; data ve meta alanlarını kendi tarafınızda işleyin.
Sıkça Sorulan Sorular
API anahtarını kendim oluşturabilir miyim?
Hayır. Anahtarı OvoCRM tanımlayıp size iletir. Böylece hangi hesabın hangi veriye, hangi işlem için eriştiği kontrollü kalır. Ek yetki gerekirse bizimle iletişime geçmeniz yeterli.
Kimlik doğrulama nasıl çalışıyor?
Her isteğe anahtarınızı x-api-key başlığında eklersiniz; anahtar ovc_live_ ile başlar. Anahtarı bir parola gibi saklayın — herkese açık kodda veya tarayıcı tarafında tutmayın. Sızarsa bize bildirin, anında iptal edilip yenisi verilir.
403 hatası alıyorum, bir şey mi bozuk?
Hayır. 403, o işlem için kapsamınızın olmadığı anlamına gelir — örneğin yalnız companies:read verilmişken firma oluşturmaya çalışmak. Gereken kapsamı bizden isteyebilirsiniz.
Hangi verilere erişebilirim?
Firmalar, kişiler, fırsatlar, teklifler, siparişler, faturalar, sevkiyatlar, ürünler, banka ve kasa hesapları. Her kaynakta liste ve tek kayıt okuma vardır; yazma işlemleri size verilen kapsama bağlıdır.
Başka firmaların verisini görebilir miyim?
Hayır. Yalnızca kendi hesabınızın verisine erişirsiniz. Başka bir hesaba ait bir kaydı istediğinizde 404 alırsınız.
Hız sınırı ne kadar?
Anahtar başına hız sınırı uygulanır. Sınırı aşarsanız 429 dönerler; kısa bir bekleyip tekrar deneyin. Toplu işlemlerde istekleri makul aralıklarla göndermeniz yeterlidir.
API hangi pakette var?
OvoCRM Premium pakete dahildir. Kullanmak için bizimle iletişime geçip anahtar talep etmeniz gerekir.
Webhook veya test (sandbox) ortamı var mı?
Webhook var: uygulamada API sayfasından adresinizi ve dinlemek istediğiniz olayları tanımlarsınız; her bildirim HMAC-SHA256 ile imzalı gelir. Ayrı bir test (sandbox) ortamı ise şu anda yok.
Kendi sisteminizi OvoCRM'e bağlayalım.
Hangi verilere hangi işlemler için erişmeniz gerektiğini konuşalım, anahtarınızı kapsamlarıyla birlikte tanımlayalım.