Webhook'lar

Belirli olaylar gerçekleştiğinde Otomovena, tanımladığınız HTTPS uç noktasına imzalı bir HTTP POST isteği gönderir.

Kurulum

Galeri panelinizde Geliştirici / API > Webhook'lar sayfasından bir hedef URL ve abone olmak istediğiniz olayları tanımlayın. "Test Et" butonuyla anında örnek bir test.ping bildirimi gönderip uç noktanızın doğru yanıt verdiğini doğrulayabilirsiniz — bu buton, katalogdaki TEK gerçekten tetiklenen olaydır.

Desteklenen Olaylar (Katalog)

Hesap / Şube

Araçlar

Araç Medyası

Müşteriler

Kefiller

Satışlar

Taksitler

Tahsilat

Ödeme Sözleri

Belgeler

Senetler

Görevler

Bayi Ağı Teklifleri

Takas Talepleri

Bayi Ağı Açık Artırmaları

Pazaryeri

Açık Artırma Talepleri

Canlı Açık Artırmalar

Üyelik / Lisans

Cüzdan

Öne Çıkarma

İçe Aktarma Merkezi

Bildirimler

Test

İmza Doğrulama

Her istek, webhook'unuza özel gizli anahtar ile HMAC-SHA256 imzalanır ve X-Otomovena-Signature header'ında gönderilir. Olay türü ayrıca X-Otomovena-Event header'ında yer alır.

<?php
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_OTOMOVENA_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $payload, $yourWebhookSecret);

if (!hash_equals($expected, $signature)) {
    http_response_code(401);
    exit;
}

$event = json_decode($payload, true);
// $event['event'], $event['data'] ...

Örnek Gövde

{
  "event": "test.ping",
  "created_at": "2026-08-02T12:00:00Z",
  "data": { "message": "Bu bir test bildirimidir." }
}

Gerçek iş olayları (ör. vehicle.sold) bağlandığında gövde şekli aynı kalacak, yalnızca event ve data alanları o olaya özel içerikle dolacaktır.

Yeniden Deneme

Uç noktanız 2xx dışında bir kod döndürürse veya zaman aşımına uğrarsa, gönderim başarısız olarak loglanır ve panelinizdeki "Son Gönderim Kayıtları" bölümünden görülebilir. Otomatik yeniden deneme (exponential backoff) mekanizması yol haritasındadır — şu an için başarısız gönderimleri "Test Et" ile manuel tekrar tetikleyebilirsiniz.