Web sitenizi SDHub'a bağlayın.

1. Yayın isteği

Haber yayımlanırken sitenizin adresine aşağıdaki gövde gönderilir. «section» ve «slot», SDHub Ayarlar › Web sitesi › Bölümler'deki eşlemeden gelir; boşsa haber bölümüne kronolojik girer.

POST https://siteniz.com/sdhub-alici
Content-Type: application/json; charset=utf-8
X-SDHub-Timestamp: 1792929600
X-SDHub-Id: 3f9c…(32 hex)
X-SDHub-Signature-V2: v2=<HMAC-SHA256(timestamp.id.body, secret)>
X-SDHub-Signature: sha256=<HMAC-SHA256(body, secret)>

{
  "title": "…", "content": "<p>…</p>", "excerpt": "…",
  "featured_image": "https://…", "images": ["https://…"], "video_url": "",
  "featured_image_data": "…base64…", "featured_image_name": "haber.jpg", "featured_image_type": "image/jpeg",
  "ic_gorseller": [{"sira": 1, "data": "…base64…", "name": "ic-1.jpg", "type": "image/jpeg", "kaynak": "https://…"}],
  "ic_foto_yeri": "galeri",
  "documents": [], "tags": ["…"], "categories": ["Gündem"],
  "source": "…", "source_url": "https://…", "account_id": "…",
  "status": "publish", "section": "Manşet", "slot": "3",
  "timestamp": "2026-10-20T12:00:00"
}

200 / 201  {"ok": true, "url": "https://siteniz.com/haber/…"}

2. İmza ve güvenlik

Gizli anahtar SDHub'da tanımlıysa her istek imzalıdır. Kimlik doğrulama olarak Bearer ya da X-API-Key seçildiyse imza yerine o başlık gelir. SDHub yönlendirme (3xx) izlemez: adresiniz isteği doğrudan yanıtlamalıdır.

İMZA v2 (önerilen):
beklenen = "v2=" + HMAC_SHA256(gizli_anahtar, X-SDHub-Timestamp + "." + X-SDHub-Id + "." + ham_gövde)   // onaltılık
sabit süreli karşılaştırma(beklenen, X-SDHub-Signature-V2) tutmazsa → 401
|şimdi − X-SDHub-Timestamp| > 300 sn ise → 401   (tekrar gönderime karşı)
aynı X-SDHub-Id 24 saat içinde ikinci kez gelirse → yeni kayıt YAZMAYIN, ilk kaydın adresini döndürün

ESKİ v1 (geçiş süresince gönderilir):
beklenen = "sha256=" + HMAC_SHA256(gizli_anahtar, ham_gövde)
sabit süreli karşılaştırma(beklenen, X-SDHub-Signature) tutmazsa → 401

Gizli anahtar web kökünün DIŞINDA durur (ortam değişkeni ya da web kökü dışındaki dosya); tema dosyasına yazılmaz.

PHP kullanıyorsanız: en az 8.5.12 / 8.4.27 / 8.3.36 / 8.2.35 (21.10.2026 güvenlik sürümü, CVE-2026-109618/109619);
yaması henüz çıkmamış CVE-2026-115560 için php.ini'de session.upload_progress.enabled=0; sürümü gizleyin: expose_php=Off

3. Bölümler, sıra (slot) ve alan (zone)

Sitenizin adresi bu isteği yanıtlarsa, SDHub'da «Bağlantıyı Test Et» başarılı olunca bölümler sıra ve alanlarıyla kendiliğinden gelir. Bu istekte site hiçbir kayıt yazmamalıdır. Sınırlar: name en çok 80, category en çok 120, zone en çok 60 karakter; slots 0–100 arası tam sayı (0 = sıra yok).

{"islem": "bolumler", "account_id": "…", "timestamp": "2026-10-20T12:00:00"}

200  {"ok": true, "sections": [
  {"name": "Manşet", "category": "Gündem", "slots": 10, "zone": "hero"},
  {"name": "Spor",   "category": "Spor",   "slots": 0,  "zone": ""}
]}

4. Kategoriler ve bağlantı testi

{"islem": "kategoriler", …}  →  200 {"ok": true, "categories": [{"name": "Gündem", "slug": "gundem"}]}
{"test": true, …}               →  200 {"ok": true}   (kayıt yazılmaz / no record is written)

WordPress ve Ghost sitelerde kategoriler (Ghost'ta etiketler) SDHub'a kendiliğinden gelir; bölüm, sıra ve alan elle girilir.