E-Ticaret

marketplace

42 uç · /api/shop/v1/marketplace

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 42 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/marketplace/attribute-map

Attr list

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

Attr upsert

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

Cat list

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

Cat upsert

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

Cat delete

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

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

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

Sebep-kodu oluştur/güncelle (upsert code). Boş kod → 400; geçersiz tip → 400.

Oturum
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/marketplace/commission-rules" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/shop/v1/admin/marketplace/commission-rules/{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/marketplace/commission-rules/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/marketplace/connections

List connections

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

Create connection

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

Bağlantıyı güncelle: config ve/veya status (verilmeyen alan korunur). status

OturumYol parametresi: connection_id

∈ {active,paused}; geçersiz → 400. Yoksa 404. (BLE-5078) **BLE2-5080 · config artık BİRLEŞTİRİLİR (||), üzerine yazılmaz.** Liste ucu sırları döndürmediği için (bkz. [redact_config]) panelin elinde config'in tamamı yoktur; eskiden olduğu gibi tüm nesneyi değiştirmek, kaydedilen her düzenlemede API sırrını SESSİZCE silerdi. Birleştirme aynı zamanda kısmi düzenlemeyi (yalnız depo kodunu değiştir) mümkün kılar. Bir anahtarı gerçekten silmek isteyen null gönderir (jsonb || null'ı yazar) — bu bilinçli ve görünür bir eylemdir.

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

Bağlantıyı sil (yoksa 404). Import-defteri/writeback kayıtları connection_id'ye FK-siz referans

OturumYol parametresi: connection_id

tutar → tarihsel kayıt korunur. (BLE-5078)

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

Probe connection

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

ZIP'ten tema dosyalarını içeri al. Ham gövde (application/zip).

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

Ürün-itme (push): aktif varyantları normalize edip bağlayıcıya gönder (stub kabul-sayar).

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

Probe connection

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

Kayıtlı + rezerve connector'lar + yetenek tanımları (bağlantı-öncesi seçim UI'si için). (BLE-5069)

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

Member revoke

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

Cat missing

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

Writebacks list

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

Writebacks process

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

Siparişi satıcılara böl (admin tetik; idempotent).

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/marketplace/orders/<order_id>/split" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/marketplace/orders/{order_id}/vendors/{vendor_id}/refund

İade → komisyon geri-alma (admin).

OturumYol parametresi: order_idvendor_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/marketplace/orders/<order_id>/vendors/<vendor_id>/refund" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/marketplace/price

Price

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

BLE-5094 · storefront kargo-teklifi: sepet + ülke → ağırlık/desi-uyumlu oranlar.

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

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

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

Sebep-kodu oluştur/güncelle (upsert code). Boş kod → 400; geçersiz tip → 400.

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

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

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

Storefront: adres otomatik-tamamlama önerileri (checkout adres-alanı seam).

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

Katalog senkronu (MOCK: pending eşlemeleri 'synced' işaretler, external_item_id stub üretir; gerçek

Oturum

katalog-push canlı API = TF21). Sync-job kaydı + sayımlar döner. Kanal yoksa 404.

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

Commission rule list

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

Commission rule create

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

Commission rule delete

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

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

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

Cihaz-token kaydet/güncelle (upsert token). opt_in default true; false → gelmez (opt-out). Topics

Oturum

aboneliği eklenir. Geçersiz platform → 400.

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

Member list

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

Member create

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

Payouts

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

Payout

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

Havuzdan bir anahtar tahsis et (atomik; çift-tahsis yok). Havuz boş → 409.

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

Satıcı hakedişi (settlement): accrued tahakkukları payout'a topla.

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

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

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/marketplace/vendors/<id>/status" \
  -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