posts — Web (Site Kurucu) API

GET/api/web/public/v1/posts

`GET /api/web/public/v1/posts` — yayındaki blog yazıları.

API anahtarı

İstek

curl -X GET "https://{slug}--panel.web.blesyum.app/api/web/public/v1/posts" \
  -H "Authorization: Bearer blsk_..." \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PATCH/api/web/v1/posts/{id}/comments

`PATCH /api/web/v1/posts/{id}/comments` — yazı bazlı kapatma (BLE2-13398).

OturumYol parametresi: id

⚠ İzin `content.write`: bu bir İÇERİK kararıdır (bu yazıda tartışma olsun mu), kişisel veriye erişim değil.

İstek

curl -X PATCH "https://{slug}--panel.web.blesyum.app/api/web/v1/posts/<id>/comments" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PATCH/api/web/v1/posts/{post}

`PATCH /api/web/v1/posts/{post}`

OturumYol parametresi: post

İstek

curl -X PATCH "https://{slug}--panel.web.blesyum.app/api/web/v1/posts/<post>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/web/v1/posts/{post}/duplicate

`POST /api/web/v1/posts/{id}/duplicate` — yazı kopyalama (BLE2-13373).

OturumYol parametresi: post

# 🔴 Kopya TASLAK doğar Yayında doğan bir kopya, aynı içeriği İKİ adreste birden yayına sokar ve arama motoru bunu **kopya içerik** sayar — asıl yazının sıralamasını da düşürür. Kullanıcının istediği şey "bunun üstüne yazayım"dır, "bunu iki kez yayınlayayım" değil. ⚠ Sürüm GEÇMİŞİ kopyalanmaz: o, kaynağın kendi tarihidir (site kopyalamanın aynı kararı). Kopya, kaynağın CANLI (yoksa en son) sürümüyle tek bir "ilk sürüm" alır.

İstek

curl -X POST "https://{slug}--panel.web.blesyum.app/api/web/v1/posts/<post>/duplicate" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PATCH/api/web/v1/posts/{post}/plan

Post plan

OturumYol parametresi: post

İstek

curl -X PATCH "https://{slug}--panel.web.blesyum.app/api/web/v1/posts/<post>/plan" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/web/v1/posts/{post}/publish

`POST /api/web/v1/posts/{post}/publish`

OturumYol parametresi: post

İstek

curl -X POST "https://{slug}--panel.web.blesyum.app/api/web/v1/posts/<post>/publish" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/web/v1/posts/{post}/unpublish

`POST /api/web/v1/posts/{post}/unpublish` — arşive al.

OturumYol parametresi: post

🔴 `archived`, `draft`tan AYRIDIR: taslak "henüz yayınlanmadı", arşiv "yayındaydı, kaldırıldı". Birleştirmek, eski adresine gelen ziyaretçiye ne olacağı sorusunu cevapsız bırakırdı.

İstek

curl -X POST "https://{slug}--panel.web.blesyum.app/api/web/v1/posts/<post>/unpublish" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/web/v1/posts/{post}/versions

`POST /api/web/v1/posts/{post}/versions`

OturumYol parametresi: post

🔴 Defter SAYFAYLA PAYLAŞILIR (`web.page_versions`, mig 1548): append-only trigger, canlı sürüm koruması ve budama İKİ kez yazılmasın diye. Bir sürüm ya bir sayfaya ya bir yazıya aittir (CHECK).

İstek

curl -X POST "https://{slug}--panel.web.blesyum.app/api/web/v1/posts/<post>/versions" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}