Depolar (stok konumları)

Taban adres: https://api.winkwop.com/api/v1/integration/locations İzin: read_inventory.

Stok uçları depo bazlı miktarları location_id → quantity şeklinde verir/ister — ama o UUID'nin hangi fiziksel depo (İstanbul merkez, Ankara şube, fulfillment ortağı vb.) olduğunu bu uç olmadan bilemezsiniz. Genelde entegrasyonun başında bir kere çağrılır, depo id'leri kendi sisteminizde eşleştirilip saklanır — her stok güncellemesinde tekrar sorgulamanıza gerek yoktur, depo listesi sık değişmez.

Listele

curl https://api.winkwop.com/api/v1/integration/locations \
  -H "X-Api-Key: wk_sk_..."

[
  {
    "id": "8a12...-loc-uuid",
    "name": "Merkez Depo",
    "phone": null,
    "country": "Türkiye",
    "city": "İstanbul",
    "district": "Kadıköy",
    "address": null,
    "postal_code": null,
    "is_default": true
  },
  {
    "id": "9c44...-loc-uuid",
    "name": "Ankara Şube",
    "country": "Türkiye",
    "city": "Ankara",
    "is_default": false
  }
]

is_default: true olan depo, mağaza sahibinin panelde ayarladığı ana depodur — çoğu tek-depolu mağazada stok ucundakiquantity alanı fiilen bu depoya karşılık gelir.

Tek depo

curl https://api.winkwop.com/api/v1/integration/locations/{id} \
  -H "X-Api-Key: wk_sk_..."

id yoksa ya da başka bir mağazaya aitse 404 NOT_FOUND döner.

Bu uçta olmayanlar

Entegrasyon API'si depo oluşturma/güncelleme/silme sağlamaz — depo yönetimi panelde (/admin/locations, JWT ile) yapılan bir mağaza sahibi kararı. Entegratörün ihtiyacı genelde mevcut depoları keşfedip stok yazarken doğru location_id'yi hedeflemek; bu yüzden kapsam bilinçli olarak salt okunur tutuldu.