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