SuiteCRM REST API ve GraphQL Entegrasyon Rehberi: Özel Yazılım ve ERP Bağlantıları

Günümüz modern kurumsal yazılım mimarilerinde tek başına çalışan (izole) sistemlerin devri kapanmıştır. Bir CRM platformunun gücü, şirketin mevcut ekosistemindeki ERP, e-ticaret siteleri, mobil uygulamalar, B2B portalları ve muhasebe yazılımları ile ne kadar hızlı ve güvenli entegre olabildiğiyle doğrudan orantılıdır.

SuiteCRM 8, sunduğu gelişmiş REST API (v8 / OAuth2) ve modern GraphQL API altyapısı sayesinde geliştiricilere ve CTO’lara tam bir esneklik sunar. Kapalı SaaS platformlarının aksine SuiteCRM’de API çağrı limiti (API rate limits), veri depolama kotası veya ek lisans ücreti zorunluluğu yoktur.

Bu rehberde, yazılım geliştiriciler ve teknik yöneticiler için SuiteCRM API mimarisini, kimlik doğrulama adımlarını, verimli CRUD işlemlerini ve Advocotek entegrasyon pratiklerini inceliyoruz.

SuiteCRM API Mimarisinin Temel Taşları

SuiteCRM 8, önceki sürümlere kıyasla modern standartlarda tamamen yeniden tasarlanmış bir API katmanı sunar:

1. OAuth2 Güvenlik Standardı: JSON Web Tokens (JWT) ile güvenli client-credentials veya password grant türlerinde kimlik doğrulama.
2. GraphQL Endpoint: İhtiyaç duyulan verinin tam olarak çekilmesini sağlayarak bant genişliğini ve sunucu yükünü minimize eder.
3. REST v8 API: JSON:API spesifikasyonuna uygun CRUD (Create, Read, Update, Delete) işlemleri.
4. Sınırsız Çağrı Özgürlüğü: Günlük API çağrı sınırı veya kullanıcı başına ek maliyet olmaması.

1. OAuth2 Kimlik Doğrulama (Authentication)

SuiteCRM API ile etkileşime geçmek için öncelikle OAuth2 jetonu (access_token) alınması gerekir.

POST /api/oauth/access_token

{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "scope": ""
}

Başarılı Yanıt:

{
  "token_type": "Bearer",
  "expires_in": 3600,
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1Ni..."
}

2. REST API ile Modül İşlemleri (JSON:API Formatı)

Kimlik doğrulamasının ardından Bearer token başlığı eklenerek SuiteCRM modüllerinde veri okuma ve yazma işlemleri gerçekleştirilir.

Yeni Müşteri Hesabı Oluşturma (Create Account)

POST /api/v8/modules/Accounts

{
  "data": {
    "type": "Accounts",
    "attributes": {
      "name": "Advocotek Bilişim A.Ş.",
      "phone_office": "+90 212 000 00 00",
      "website": "https://advocotek.com",
      "industry": "Technology",
      "billing_address_city": "İstanbul"
    }
  }
}

Müşteri Arama ve Filtreleme (Get Accounts with Filter)

GET /api/v8/modules/Accounts?filter[name][eq]=Advocotek

3. SuiteCRM GraphQL API ile Yüksek Performanslı Sorgular

Mobil uygulamalar veya hızlı web portalları için GraphQL, aşırı veri çekmeyi (over-fetching) engeller.

query GetCustomerDetails($accountId: ID!) {
  account(id: $accountId) {
    id
    name
    phone_office
    contacts {
      first_name
      last_name
      email1
    }
    opportunities {
      name
      amount
      sales_stage
    }
  }
}

En Sık Kullanılan Entegrasyon Senaryoları

A. E-Ticaret & WooCommerce / Shopify Entegrasyonu

Web sitenizden yapılan yeni siparişler ve üyelikler anında SuiteCRM’eaktarılır. Müşterinin satın alma geçmişi ve sepette bıraktığı ürünler temelinde otomatik e-posta pazarlama dizileri tetiklenir.

B. ERP (SAP, Logo, Mikro, Netsis) Çift Yönlü Entegrasyonu

• Sipariş Senkronizasyonu: CRM’de kapatılan satış fırsatları ERP’ye fatura siparişi olarak aktarılır.
• Stok Güncellemesi: ERP’deki stok miktarları ve fiyat listeleri periyodik cron işleriyle CRM modüllerine yansıtılır.

C. Özel Mobil Uygulama (Flutter / React Native) Bağlantısı

Saha satış temsilcilerinin kullandığı özel mobil uygulamalar, SuiteCRM REST API üzerinden anlık konum, ziyaret notu ve teklif oluşturma verilerini iletir.

SuiteCRM API Entegrasyonlarında En İyi Uygulamalar (Best Practices)

1. Webhook ve Logic Hook Kullanımı: CRM’de bir olay gerçekleştiğinde (örn. yeni lead oluştuğunda) harici sistemlere push bildirimi göndermek için Logic Hook yapılarını tercih edin.
2. Token Caching: Her API çağrısında yeniden OAuth2 token almak yerine token süresi dolana kadar (3600 sn) hafızada tutun.
3. Queue ve Asenkron İşleme: Yüksek hacimli veri aktarımlarında (ör. 10.000+ fatura aktarımı) kuyruk mekanizmaları (RabbitMQ veya Redis) kullanın.

Advocotek ile API ve Entegrasyon Projelerinizi Gerçekleştirin

SuiteCRM’in açık kaynak ve esnek API yapısı, kurumunuzun dijital ekosistemini kesintisiz biçimde bağlamanızı sağlar. Advocotek yazılım ekibi olarak, özel ERP konnektörleri, mobil API katmanları ve mikroservis mimarilerinde uçtan uca destek sunuyoruz.

👉 Teknik Entegrasyon Danışmanlığı Alın veya SuiteCRM Mimarisini İnceleyin.