app-store — E-Ticaret API

POST/api/shop/v1/admin/app-store/apps/{app_id}/install

Install

OturumYol parametresi: app_id

İstek

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

Yanıt

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

POST/api/shop/v1/admin/app-store/apps/{app_id}/reviews

BLE-5506/6365/5636/5760 · önizle-sonrası insan-onayı: done-job approve edilirse görsel-türlerde

OturumYol parametresi: app_id

çıktı (`result_ref`) ürün-medya galerisine bağlanır (storage-key = stub-ref; canlı obje-storage TF21 aynı sözleşme); discard → çıktı yayınlanmadan kapanır. Geri-al: bağlanan medya mevcut media-delete ucuyla kaldırılır (media_id yanıtta). done-olmayan job → 409.

İstek

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

Yanıt

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

POST/api/shop/v1/admin/app-store/apps/{app_id}/uninstall

Uninstall

OturumYol parametresi: app_id

İstek

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

Yanıt

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

GET/api/shop/v1/admin/app-store/billing-plans

Plans list

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/app-store/billing-plans

Create plan

Oturum

İstek

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

Yanıt

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

GET/api/shop/v1/admin/app-store/billing-plans/{plan_id}/usage

inc-C: bir planın kullanım-kayıtlarını listele (en yeni önce).

OturumYol parametresi: plan_id

İstek

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

Yanıt

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

POST/api/shop/v1/admin/app-store/billing-plans/{plan_id}/usage

inc-C: bir plana kullanım-tabanlı (metered) charge raporla (cycle-tavanına dek; idempotent).

OturumYol parametresi: plan_id

Cap aşılırsa 409 + remaining_minor. Aynı idempotency_key tekrar → replay (çift-charge yok).

İstek

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

Yanıt

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

POST/api/shop/v1/admin/app-store/billing-plans/process-due

Admin-tetik: vadesi-gelen recurring app-charge'ları ŞİMDİ işle (manuel sweep; worker zaten periyodik

Oturum

koşar). Saat DAİMA gerçek-zaman — client `now` override YOK. Aksi hâlde STORE_MANAGE'li personel geleceğe `now` vererek recurring defter-charge'ı erkene çekebilir / cycle-cycle ileri sararak defter-kirliliği üretebilirdi (idempotency çift-charge'ı engeller ama zaman-yolculuğunu değil). Yalnız catch-up (BLE-8922 now-clamp sertleştirme).

İstek

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

Yanıt

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

GET/api/shop/v1/admin/app-store/catalog

BLE-5957 · katalog + kategori/arama (crate `catalog` + isim/açıklama q-filtresi).

Oturum

İstek

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

Yanıt

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

GET/api/shop/v1/admin/app-store/charges

Charges list

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/app-store/charges

Charge

Oturum

İstek

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

Yanıt

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

GET/api/shop/v1/admin/app-store/installed

Installed

Oturum

İstek

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

Yanıt

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

PUT/api/shop/v1/admin/app-store/settings

`app_store` ayarı: OPT-IN komisyon (kullanıcı-onaylı; 0..=10000 bps, varsayılan 0).

Oturum

İstek

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

Yanıt

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