Odoo API Entegrasyon Kılavuzu: Odoo'yu Herhangi Bir Sisteme Bağlayın

Odoo nadiren tek başına çalışır. Businesses need it connected to eCommerce platforms, payment processors, shipping carriers, marketing tools, and custom applications. Odoo Harici API, herhangi bir sistemin Odoo'daki kayıtları programlı olarak okumasını, oluşturmasını, güncellemesini ve silmesini sağlayan XML-RPC ve JSON-RPC olmak üzere iki protokol sağlar.

Kimlik Doğrulama

API Anahtarı Kimlik Doğrulaması

Odoo'da bir API anahtarı oluşturun: kullanıcı profilinize, ardından Hesap Güvenliği'ne ve ardından API Anahtarlarına gidin. Açıklayıcı bir etikete sahip bir anahtar oluşturun. API kimlik doğrulaması için şifreniz yerine bu anahtarı kullanın; oturum açma kimlik bilgileriniz değiştirilmeden bağımsız olarak iptal edilebilir.

Bağlantı Parametreleri

Her API çağrısı şunları gerektirir: Odoo sunucusu URL'si, veritabanı adı, kullanıcı adınız (giriş e-postası) ve API anahtarı. Bunları güvenli bir şekilde saklayın; kimlik bilgilerini asla kaynak koduna sabitlemeyin.

XML-RPC Protokolü

Bağlantı Kurulumu

XML-RPC iki uç nokta kullanır: kimlik doğrulama için /xmlrpc/2/common ve veri işlemleri için /xmlrpc/2/object. Bir kullanıcı kimliği almak için önce kimlik doğrulaması yapın, ardından sonraki aramalar için bu kimliği kullanın.

CRUD İşlemleri

Arama ve Okuma: Etki alanı filtreleriyle kayıtları sorgulama (SQL WHERE cümleciklerine benzer). Alan adları tuple'lar kullanır: [('state', '=', 'sale'), ('amount_total', '>', 1000)] 1.000 ABD dolarının üzerindeki onaylanmış satış siparişlerini bulur.

Oluştur: Alan değerleri sözlüğünü iletin. API yeni kayıt kimliğini döndürür. Zorunlu alanlar dahil edilmelidir, aksi takdirde çağrı doğrulama hatasıyla başarısız olur.

Yaz: Kayıt kimliklerini ve değiştirilen değerlerin sözlüğünü ileterek mevcut kayıtları güncelleyin. Yalnızca değiştirmek istediğiniz alanları ekleyin.

Bağlantıyı kaldır: Kayıtları kimliğe göre silin. Dikkatli kullanın; bağımlı kayıtları varsa bazı kayıtlar silinemez.

JSON-RPC Protokolü

Neden JSON-RPC

JSON-RPC genellikle modern entegrasyonlar için tercih edilir: JSON'u kullanır (XML'den daha geliştirici dostudur), JavaScript/TypeScript uygulamalarıyla daha iyi çalışır ve büyük veriler için biraz daha iyi performans sunar.

Talep Formatı

JSON-RPC çağrıları tek bir uç noktaya gider: /jsonrpc. Her istek, standart bir JSON-RPC 2.0 zarfında hizmet adını, yöntemini ve bağımsız değişkenleri içerir.

Ortak Entegrasyon Modelleri

e-Ticaret Sipariş Senkronizasyonu

Siparişleri Shopify veya WooCommerce'den Odoo'ya senkronize edin:

1. E-Ticaret platformundaki sipariş web kancalarını dinleyin
2. Müşteri verilerini Odoo iş ortağı kayıtlarıyla eşleyin (mevcut olanı oluşturun veya eşleştirin)
3. Odoo ürünleriyle eşlenen satır öğeleriyle bir satış siparişi oluşturun
4. Siparişi yerine getirme iş akışlarını tetiklemek için onaylayın
5. İzleme bilgilerini e-Ticaret platformuna geri senkronize edin

Ödeme İşlemcisi Entegrasyonu

Stripe, PayPal veya diğer işlemcileri bağlayın:

1. Ödeme onayı web kancalarını alın
2. Ödemeleri Odoo faturalarıyla referans numarasına göre eşleştirin
3. Ödemeyi Odoo Muhasebe'ye kaydedin
4. Banka ekstreleriyle otomatik olarak mutabakat sağlayın

CRM Senkronizasyonu

Odoo CRM'yi harici pazarlama araçlarıyla senkronize tutun:

1. Pazarlama platformlarından gelen yeni potansiyel müşteriler Odoo potansiyel müşterileri yaratıyor
2. Lider puanlama güncellemeleri çift yönlü olarak akar
3. Kazanılan fırsatlar, pazarlama aracında takip kampanyalarını tetikler
4. İletişim bilgileri sistemler arasında senkronize kalır

Hata İşleme

Yaygın Hatalar

• Erişim reddedildi: Geçersiz kimlik bilgileri veya yetersiz izinler
• Doğrulama hatası: Gerekli alanlar eksik veya geçersiz değerler
• Kayıt bulunamadı: Var olmayan bir kimliğe başvuruluyor
• Eşzamanlı güncelleme: Başka bir kullanıcı kaydı aynı anda değiştirdi

En İyi Uygulamalar

1. Geçici hatalar için üstel geri çekilme ile yeniden deneme mantığını uygulayın
2. Hataları erken yakalamak için göndermeden önce verileri doğrulayın
3. **Hata ayıklama ve denetim amacıyla tüm API çağrılarını günlüğe kaydedin
4. Hız sınırlarını yönetin — bireysel çağrılar yerine toplu işlemler
5. Başarısız çağrıları güvenli bir şekilde yeniden denemek için bağımsız işlemleri kullanın

Performans Optimizasyonu

• Toplu okumalar: Ayrı search + read çağrıları yerine search_read kullanın
• Alanları sınırla: Modeldeki tüm alanları değil, yalnızca ihtiyacınız olan alanları isteyin
• Sayfalandırma: Büyük sonuç kümeleri için limit ve offset kullanın
• Önbelleğe alma: Yavaş değişen verileri (ürün katalogları, döviz kurları) yerel olarak önbelleğe alın

Web Kancası Modelleri

Odoo'nun tüm sürümlerinde yerel giden web kancaları yoktur. Ortak yaklaşımlar:

• Otomatik işlemler: Kayıt değişikliklerinde tetiklenen ve harici URL'leri çağıran sunucu işlemleri
• Özel denetleyiciler: Harici sistemler için webhook uç noktalarını açığa çıkaran bir Odoo modülü oluşturun
• Yoklama: Harici sistemler, değişiklikler için aralıklarla Odoo'yu yoklar (daha basit ancak daha az gerçek zamanlı)

Güvenlik Hususları

• Şifreler yerine API anahtarlarını kullanın
• API erişimini ağ düzeyinde IP adresine göre kısıtlayın
• Tüm API iletişimi için HTTPS kullanın
• Uygun erişim haklarını uygulayın — API kullanıcılarının gerekli minimum izinlere sahip olması gerekir
• API anahtarlarını düzenli aralıklarla değiştirin ve güvenliği ihlal edilmiş anahtarları derhal iptal edin

Odoo entegrasyon hizmetimiz, uygun hata işleme, izleme ve güvenlik ile üretim düzeyinde entegrasyonlar oluşturur.

Sıkça Sorulan Sorular

Hangi protokolü kullanmalıyım — XML-RPC mi yoksa JSON-RPC mi?

Yeni projeler için JSON-RPC. Daha geliştirici dostudur, modern araçlarla daha iyi çalışır ve Odoo'nun gittiği yöndür. Daha iyi XML-RPC kitaplığı desteğine sahip eski sistemler veya diller için XML-RPC.

REST API var mı?

Odoo 17+, RPC uç noktalarının yanında bir REST API içerir. JSON yükleriyle standart REST kurallarına uyar ve web uygulamaları için çalışması genellikle daha kolaydır.

Büyük veri geçişlerini nasıl halledebilirim?

İlk veri yüklemeleri için CSV içe aktarma özelliğini kullanın veya her toplu iş için hata işlemeyle birlikte toplu kayıtlar (toplu iş başına 100-500 kayıt) oluşturan bir geçiş komut dosyası yazın.

API'yi özel uç noktalarla genişletebilir miyim?

Evet. Standart API'nin kapsamadığı özel işlemler için ek HTTP uç noktalarını açığa çıkaran denetleyici sınıflarına sahip özel Odoo modülleri oluşturun.