voice — E-Ticaret API

POST/api/shop/v1/admin/voice/campaigns/{campaign_ref}/generate-abandoned

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

OturumYol parametresi: campaign_ref

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 POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/voice/campaigns/<campaign_ref>/generate-abandoned" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

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

GET/api/shop/v1/admin/voice/campaigns/{campaign_ref}/targets

Targets

OturumYol parametresi: campaign_ref

İstek

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

Yanıt

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

GET/api/shop/v1/admin/voice/order-status/{order_number}

Public-api durum ucu: geçerli API versiyonu + deprecation/sunset (X-Api-Version başlığıyla).

OturumYol parametresi: order_number

İstek

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

Yanıt

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

GET/api/shop/v1/admin/voice/sessions

Sessions

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/voice/sessions

Yeni asistan oturumu (unguessable token). Storefront.

Oturum

İstek

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

Yanıt

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

POST/api/shop/v1/admin/voice/sessions/{id}/abandon

Abandon

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/shop/v1/admin/voice/sessions/{id}/confirm

CRM-worker geri-yazımı (consume-seam): contact-id ile pending→synced. Idempotent.

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/shop/v1/admin/voice/sessions/{id}/items

Listeye varyant ekle (sahip-doğrulama; varyant var-kontrolü; eklendiğinde-fiyat snapshot). Idempotent.

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/shop/v1/admin/voice/targets/{id}/mark

Mark

OturumYol parametresi: id

İstek

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

Yanıt

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