Shortmox Tools · entegrasyon rehberi

Webhook Inbox — entegrasyon rehberi

Üçüncü parti servislerden gelen HTTP isteklerini güvenli biçimde incelemek için yakalama ucu. Başlıklar maskelenir; gövde metin/JSON olarak saklanır. Bu araç hukuki kayıt veya denetim deposu değildir.

Bu rehber hukuki veya denetim danışmanlığı değildir. Üretim anahtarlarınızı depolamayın; örneklerde YOUR_* yer tutucuları kullanın. Admin panoları ve çoğu yazma API’si oturum gerektirir — ayrıntılar erişim politikası.

Uç nokta

/api/tools/webhooks/YOUR_INBOX_KEY — yöntem ve gövde sağlayıcıya bağlıdır. Yanıt genelde { ok, id, receivedAt }JSON'udur (HEAD hariç).

Örnek: curl ile POST

# YOUR_INBOX_KEY panoda oluşturulur — örnekte yer tutucu
curl -i -X POST "https://YOUR_DOMAIN/api/tools/webhooks/YOUR_INBOX_KEY" \
  -H "content-type: application/json" \
  -d '{"event":"demo","ok":true}'

# Üretim API anahtarlarınızı veya ham OAuth token'ı gövdeye koymayın — staging verisi kullanın.

Güvenlik ve kötüye kullanım

  • Üretim sırlarını (API key, OAuth refresh, ham cookie) bu uca yönlendirmeyin — staging veya imzasız örnek payload kullanın.
  • Oran sınırları aşıldığında 429 dönebilir.
  • Kayıtlar teknik inceleme içindir; compliance garantisi yoktur.

Sık sorulanlar

YOUR_INBOX_KEY nedir?

Yer tutucudur; gerçek anahtar panoda üretilir ve URL parçasıdır. Repo, destek bileti veya tarayıcı uzantısı ile sızdırmayın.

Authorization veya Cookie başlıkları saklanır mı?

Sunucu tarafında hassas başlık adları maskelenir; yine de üretim erişim belirteçlerini test trafiğinde bu uca göndermeyin.

Hangi HTTP metotları desteklenir?

GET, HEAD, POST, PUT, PATCH, DELETE ve OPTIONS desteklenir; gövde boyutu üst sınıra tabidir.

Panodan nasıl okurum?

İstek geçmişi yönetici oturumuyla panoda listelenir; bu rehber yalnızca yakalama ucunu anlatır.