onboarding — E-Ticaret API

GET/api/shop/v1/admin/onboarding

Sihirbaz durumu: adım → done (manuel ∪ auto) + dismissed bayrağı.

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/onboarding/complete-step

Adımı manuel tamamla (idempotent; whitelist-dışı 400).

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/onboarding/dismiss

Sihirbazı kapat (dismissed=true; panel bir daha göstermez).

Oturum

İstek

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

Yanıt

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

GET/api/shop/v1/admin/onboarding/resume

GET /admin/onboarding/resume?token=X — resume-token ile durumu çöz (bilinmeyen → 404).

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/onboarding/seed-sample

Tek-tık örnek-veri: demo kategori + ürün + varsayılan varyant (₺ fiyatlı). Sihirbazın

Oturum

"sıfır-durumdan keşif" adımı — merchant kataloğu boşken bir örnek görür. Idempotent: zaten seed'liyse 409 (önce geri-al). Seed'lenen id'ler settings `onboarding.sample_seed`'e yazılır → geri-al tam bunları hedefler. Handle/slug'a eşsiz sonek (soft-delete sonrası yeniden-seed handle-çakışmasını önler). catalog helper'ları REUSE (money-safe fiyat i64).

İstek

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

Yanıt

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

POST/api/shop/v1/admin/onboarding/seed-sample/undo

Örnek-veriyi geri-al: seed'lenen ürünü soft-delete + kategoriyi sil + `sample_seed` temizle.

Oturum

Seed yoksa 404. Yalnız sihirbazın oluşturduğu id'leri hedefler (merchant'ın gerçek verisine dokunmaz).

İstek

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

Yanıt

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

GET/api/shop/v1/admin/onboarding/state

GET /admin/onboarding/state — adanmış durum (resume-token + tamamlanma-%).

Oturum

İstek

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

Yanıt

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

PUT/api/shop/v1/admin/onboarding/state

PUT /admin/onboarding/state — last_step / dismissed günceller (satır yoksa önce oluşturur).

Oturum

İstek

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

Yanıt

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