⚙️ 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-Signaturebaş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.