E-Ticaret

collections

22 uç · /api/shop/v1/collections

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 22 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/shop/v1/admin/collections

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

Oturum
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/collections

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/collections" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PATCH/api/shop/v1/admin/collections/{collection_id}

Collection update

OturumYol parametresi: collection_id
İstek
curl -X PATCH "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/shop/v1/admin/collections/{collection_id}

Collection delete

OturumYol parametresi: collection_id
İstek
curl -X DELETE "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/collections/{collection_id}/matches

Matches

OturumYol parametresi: collection_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/matches" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/collections/{collection_id}/merchandising

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

OturumYol parametresi: collection_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/merchandising" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/collections/{collection_id}/merchandising

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

OturumYol parametresi: collection_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/merchandising" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/collections/{collection_id}/merchandising/preview

BLE-5057 · storefront kupon-önizleme (DRY-RUN): sepet-özeti verilen kodla hesaplanır —

OturumYol parametresi: collection_id

used_count/per-customer sayaçları TÜKETİLMEZ, sipariş oluşmaz (cart_summary reuse).

İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/merchandising/preview" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/collections/{collection_id}/products

Products list

OturumYol parametresi: collection_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/products" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/collections/{collection_id}/products

Products add

OturumYol parametresi: collection_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/products" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/shop/v1/admin/collections/{collection_id}/products/{product_id}

Product remove

OturumYol parametresi: collection_idproduct_id
İstek
curl -X DELETE "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/products/<product_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/collections/{collection_id}/reevaluate

Reevaluate

OturumYol parametresi: collection_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/reevaluate" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/collections/{collection_id}/reorder

Reorder

OturumYol parametresi: collection_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/reorder" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/collections/{collection_id}/rules

Koleksiyonun kurallarını listele (BLE-5430 · kural-yapıcı ekranı).

OturumYol parametresi: collection_id

Kural ekleme/silme uçları vardı ama OKUMA yoktu: panel kural yapıcısı mevcut kuralları gösteremezdi (yalnız kör ekleme). Storefront'un kullandığı [collection_rules] REUSE edilir — ikinci bir sorgu yok, yani admin gördüğü kural ile vitrinin uyguladığı kural ayrışamaz.

İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/rules" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/collections/{collection_id}/rules

Rule add

OturumYol parametresi: collection_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/rules" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/shop/v1/admin/collections/{collection_id}/rules/{rule_id}

Rule delete

OturumYol parametresi: collection_idrule_id
İstek
curl -X DELETE "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/rules/<rule_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/collections/{collection_id}/sort-rule

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

OturumYol parametresi: collection_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/sort-rule" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/shop/v1/admin/collections/{collection_id}/sort-rule

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

OturumYol parametresi: collection_id
İstek
curl -X PUT "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/sort-rule" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/collections/{collection_id}/sort-rule/recompute

Recompute

OturumYol parametresi: collection_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/collections/<collection_id>/sort-rule/recompute" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/headless/collections

Koleksiyonlar (read_collections). Public list_collections_nav'ı REUSE eder (title+slug).

Oturum
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/headless/collections" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/storefront/collections

Collections nav

Oturum
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/collections" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/storefront/collections/{slug}

Collection page

OturumYol parametresi: slug
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/collections/<slug>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al