Ohana360Yardım Merkezi
Ana SayfaKurulum ve YönetimAPI, Bearer token'lar ve webhook'lar
⚙️ Kurulum ve Yönetim

API, Bearer token'lar ve webhook'lar

Ohana360'ı diğer sistemlere bağlayın: API token üretimi, REST uçları ve HMAC imzalı webhook bildirimleri.

API token'ları

Kurulum > API Token'ları ekranından org'unuz için erişim anahtarı üretirsiniz. Token, istekte Authorization: Bearer <token> başlığıyla kullanılır.

  • Token'lar org'a bağlıdır ve istediğiniz an iptal edilebilir.
  • Her entegrasyon için ayrı token üretin; iptal gerektiğinde yalnız o bağlantı kesilir.
Güvenlik: Token bir şifredir: kod deposuna, e-postaya veya ekran görüntüsüne koymayın. Sızdığından şüphelenirseniz hemen iptal edip yenisini üretin.

REST ile veri erişimi

API üzerinden kayıtları okuyabilir, oluşturabilir ve güncelleyebilirsiniz. Tipik kullanım örnekleri:

  • Muhasebe yazılımından Ohana360'a fatura durumu yazmak
  • Sitenizdeki özel formdan doğrudan kayıt açmak
  • Dış raporlama aracına veri çekmek

Webhook'lar

Kurulum > Webhook'lar'da bir URL tanımlarsınız; seçtiğiniz nesnelerde kayıt oluştuğunda/değiştiğinde Ohana360 bu adrese JSON bildirim gönderir.

  • Her bildirim X-Ohana-Signature başlığında HMAC imzası taşır: alıcı taraf, isteğin gerçekten Ohana360'tan geldiğini doğrular.
  • Ulaşamayan bildirimler kuyrukta yeniden denenir.
  • Örnek: fırsat Kazanıldı olduğunda ERP'nize sipariş açtırmak.

Akıştan webhook çağırma

Akış aksiyonu olarak da webhook tetikleyebilirsiniz: koşullarınızı akışta kurar, dış sistemi yalnız gereken durumda uyandırırsınız.

İpucu: Entegrasyona başlarken önce tek bir test kaydıyla uçtan uca akışı doğrulayın; toplu senkronu sonra açın.