OperasyonEntegrasyon Önizlemesi

Webhook'lar

Kararlar, ödüller, politika engelleri ve kill switch olayları için gerçek zamanlı bildirimler alın.

Önizleme

Olay adları, başlık adları ve yeniden deneme davranışı örnek amaçlıdır; kesin teslimat koşulları hesabınıza özel dokümanda belirtilir.

Webhook'lar, ReinoAds tarafında gerçekleşen olayları sunucunuza HTTPS POST isteğiyle iletir. Her istek imzalıdır; imzayı Kimlik Doğrulama bölümündeki yöntemle doğrulamadan gövdeyi işlemeyin.

POST/v1/webhooksBir webhook uç noktası kaydeder ve dinlenecek olayları belirler.Entegrasyon Önizlemesi

curl https://api.reinoads.com/v1/webhooks \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/reinoads",
    "events": ["decision.rewarded", "policy.blocked", "kill_switch.changed"]
  }'

Olay	Ne zaman gönderilir
decision.served	Bir reklamın gösterimi doğrulandığında
decision.rewarded	Ödüllü bir reklam tamamlandığında ve ödül hak edildiğinde
policy.blocked	Bir istek politika, ticari kural veya brand safety nedeniyle engellendiğinde
creative.review_updated	Bir kreatifin onay durumu değiştiğinde
kill_switch.changed	Bir kaynak, reklamveren veya yerleşimde kill switch açıldığında veya kapandığında

{
  "id": "evt_01HZXC4N7D",
  "type": "decision.rewarded",
  "created_at": "2026-10-06T12:00:00Z",
  "environment": "live",
  "data": {
    "decision_id": "dec_01HZX4K2Q8",
    "placement": "rewarded",
    "user_ref": "your-internal-user-ref",
    "reward": { "type": "coins", "amount": 50 }
  }
}

Olayları idempotent işleyin: aynı id ile birden fazla teslimat gelebilir.
Hızlıca 2xx yanıt dönün ve ağır işleri kuyruğa alın.
Başarısız teslimatlar örnek olarak artan aralıklarla yeniden denenir; kesin politika hesap dokümanınızda yer alır.