Webhook'lar

Webhook endpoint'lerini listele

İstek

curl https://odecik.com/api/v1/webhooks \
  -H "Authorization: Bearer $ODECIK_API_KEY"

Yanıt

Başarılı: 200400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

{
  "object": "list",
  "hasMore": false,
  "nextCursor": "string"
}

Webhook endpoint'i ekle

İmza sırrı (`secret`) yalnız bu yanıtta döner. URL bir Discord veya Slack webhook adresiyse olaylar o platformun biçiminde (imzasız) iletilir. `write` yetkisi gerekir.

Gövde (JSON)

İstek

curl -X POST https://odecik.com/api/v1/webhooks \
  -H "Authorization: Bearer $ODECIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://siteadresin.com/odecik-webhook",
    "events": [
      "order.paid",
      "order.shipped"
    ]
  }'

Yanıt

Başarılı: 201400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

{
  "id": "string",
  "url": "string",
  "target": "generic",
  "events": [
    "order.created"
  ],
  "isActive": false,
  "secret": "string",
  "createdAt": "2026-01-15T10:30:00.000Z"
}

Webhook endpoint'ini sil

`write` yetkisi gerekir.

Parametreler

İstek

curl -X DELETE https://odecik.com/api/v1/webhooks/ODC-M2K9X1-A4F2 \
  -H "Authorization: Bearer $ODECIK_API_KEY"

Yanıt

Başarılı: 200400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

{
  "id": "string",
  "deleted": false
}

Test olayı gönder

Örnek bir `order.paid` olayını endpoint'e tek denemeyle iletir ve sonucu döner. `write` yetkisi gerekir.

Parametreler

İstek

curl -X POST https://odecik.com/api/v1/webhooks/ODC-M2K9X1-A4F2/test \
  -H "Authorization: Bearer $ODECIK_API_KEY"

Yanıt

Başarılı: 200400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

{
  "ok": false,
  "responseCode": 0,
  "error": "string"
}

Teslimat geçmişi

Parametreler

İstek

curl https://odecik.com/api/v1/webhooks/ODC-M2K9X1-A4F2/deliveries \
  -H "Authorization: Bearer $ODECIK_API_KEY"

Yanıt

Başarılı: 200400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

{
  "object": "list",
  "hasMore": false,
  "nextCursor": "string"
}