feeds — E-Ticaret API

GET/api/shop/v1/admin/feeds

Credential-listesi + kaldırma (müşteri-oturumu).

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/feeds

VPOS tanımı ekle/güncelle (upsert bank). bank 1-32 char, threed_mode 3d|non3d. config_ref saklanır

Oturum

ama response'ta dönmez.

İstek

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

Yanıt

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

PATCH/api/shop/v1/admin/feeds/{id}

Slot güncelle. capacity, mevcut booked'ın altına inemez (pre-check → 409).

OturumYol parametresi: id

İstek

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

Yanıt

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

DELETE/api/shop/v1/admin/feeds/{id}

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

OturumYol parametresi: id

İstek

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

Yanıt

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

GET/api/shop/v1/admin/feeds/{id}/generate

BLE-5103/5116 · toplu kod-üretici: prefix + rastgele-sonek havuzu; çakışma önleme

OturumYol parametresi: id

on-conflict-do-nothing + yeniden-deneme (deterministik olmayan sonek UUID'den türetilir — pratikte çakışma sıfıra yakın; teoride tükenirse 409). Üretilen kodlar yanıtta döner.

İstek

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

Yanıt

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

POST/api/shop/v1/admin/feeds/process

Zamanlanmış feed-üretim tetikleyicisi (scheduler tick; admin manuel tetik + worker periyodik).

Oturum

İstek

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

Yanıt

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

GET/api/shop/v1/storefront/feeds/{id}

BLE-6084 · public feed-erişimi (imzalı-URL MVP'si): feed-başına uzun-rastgele `access_token`

OturumYol parametresi: id

query-token'ı ile doğrulanır (Google/Meta fetch'i bu URL'i çeker). Token-uyuşmazlığı / pasif / yok → tek-tip 404 (token-varlığı sızdırılmaz). Canlı Content/Catalog API push → TF21.

İstek

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

Yanıt

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

GET/api/shop/v1/storefront/feeds/google-merchant.xml

Google Merchant / Meta Catalog ürün-feed'i (XML). Ürün-başına varsayılan varyant;

Oturum

availability stok-toplamından (>0 in stock). İlk 1000 ürün (feed-sayfalama TF21 canlı-kayıt).

İstek

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

Yanıt

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