seo — E-Ticaret API

GET/api/shop/v1/admin/seo/{owner_type}/{owner_id}

Admin: retention config oku (gün eşikleri; null = o tablo için kapalı).

OturumYol parametresi: owner_typeowner_id

İstek

curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/seo/<owner_type>/<owner_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

PUT/api/shop/v1/admin/seo/{owner_type}/{owner_id}

Ürün gümrük alanlarını ayarla (HS-code rakam ≤12; menşei ISO-2/3 harf). Yoksa 404.

OturumYol parametresi: owner_typeowner_id

İstek

curl -X PUT "https://{slug}.shop.blesyum.app/api/shop/v1/admin/seo/<owner_type>/<owner_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

DELETE/api/shop/v1/admin/seo/{owner_type}/{owner_id}

BLE-5057 · sil (kalıcı; kullanım-geçmişi orders snapshot'ında yaşar).

OturumYol parametresi: owner_typeowner_id

İstek

curl -X DELETE "https://{slug}.shop.blesyum.app/api/shop/v1/admin/seo/<owner_type>/<owner_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

GET/api/shop/v1/admin/seo/jsonld-preview/{handle}

Admin (personel) SEO rotaları — admin düzlemine merge edilir.

OturumYol parametresi: handle

TF12 BLE-6233: rich-result JSON-LD admin önizlemesi — storefront'un üreteceği Product JSON-LD'sinin birebir aynısı (yayın-öncesi doğrulama; taslak/yayınsız ürün 404 = storefront davranışıyla tutarlı).

İstek

curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/seo/jsonld-preview/<handle>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

GET/api/shop/v1/admin/seo/jsonld-settings

Tüm JSON-LD şema-tipi durumları (ayarlanmamış = enabled true).

Oturum

İstek

curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/seo/jsonld-settings" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

PUT/api/shop/v1/admin/seo/jsonld-settings

Jsonld settings set

Oturum

İstek

curl -X PUT "https://{slug}.shop.blesyum.app/api/shop/v1/admin/seo/jsonld-settings" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

GET/api/shop/v1/admin/seo/jsonld-validate/{handle}

TF12 BLE-6225 rich-result doğrulayıcı: ürünün üretilecek JSON-LD'sini Google rich-result

OturumYol parametresi: handle

temel-kurallarına göre denetler — errors (sonuç engelleyici) + warnings (iyileştirme). Yayın-öncesi içerik-kalite kontrolü; harici validator-API = TF21.

İstek

curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/seo/jsonld-validate/<handle>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

GET/api/shop/v1/storefront/seo/canonical

Canonical

Oturum

İstek

curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/seo/canonical" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

GET/api/shop/v1/storefront/seo/hreflang

Aktif pazar-locale'lerden hreflang alternates üretir: dil-ülke kodu + pazar-domain'i (boşsa

Oturum

istek-host'u) + x-default (varsayılan pazar). `path` yalnız site-içi mutlak-yol olabilir ('/' ile başlar, '//' şema-enjeksiyonu reddedilir) — open-redirect/cloaking verisi üretilmez.

İstek

curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/seo/hreflang" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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