İşinizi HiCCUP'a bağlayın.

Satıcılar ürünleri tedarik eder. Pazaryerleri onları satar. Depolar onları saklar ve gönderir. Her rolün kendi API'si, kendi erişim bilgileri ve kendi referansı vardır. Aşağıdan size uygun olanı seçin.

HiCCUP'a ürün tedarik ediyorsunuz

Merchant API

Kataloğunuzu, stoğunuzu ve fiyatlarınızı iletin. Size yönlendirdiğimiz paketleri hazırlayın. Tedarikçi faturalarınızı takip edin.

POST/merchant/products/upsert
PUT/merchant/products/stock
PUT/merchant/products/price
PUT/merchant/package/markPackagesPacked

9 uç nokta, dakikada 15 istekMerchant rehberini açın HiCCUP kataloğunu kendi kanalınızda satıyorsunuz

Marketplace API

Yayındaki kataloğu, fiyatları ve stoğu çekin. Siparişleri ve iadeleri iletin. Her paketi ve sevkiyatı müşteriye ulaşana kadar takip edin.

GET/marketplace/catalog
POST/marketplace/orders
GET/marketplace/shipments/{shipmentUid}
POST/marketplace/returns

13 uç nokta, dakikada 15 ile 30 istekMarketplace rehberini açın HiCCUP stoğunu deponuzda tutuyorsunuz

Warehouse API

Eldeki miktarları barkod ya da SKU ile bildirin. HiCCUP yeni seviyeleri tüm satış kanallarına anında dağıtır.

PUT/warehouse/stock

1 uç nokta, dakikada 30 istekWarehouse rehberini açın

Tek anahtar. Tek token. Tüm API'ler.

Size verdiğimiz API anahtarını kısa ömürlü bir token ile değiştirin, ardından bu token'ı her istekte gönderin. Token kapsamınızı ve hesabınızı taşır: satıcı, kanal ya da depo kimliğini kendiniz hiçbir zaman göndermezsiniz ve kapsam istemci tarafından genişletilemez.

Token'ların süresi dolar. Bir istek 401 döndüğünde yeni bir token alın ve isteği tekrarlayın.

# 1. anahtarınızı bir token ile değiştirin
curl -X POST https://api.hiccup.dev/auth/token \
  -H "X-API-KEY: $HICCUP_API_KEY"

# yanıt: { "token": "eyJhbGciOi…", "tokenType": "Bearer", "expiresIn": 1752500000 }

# 2. API'nizi bu token ile çağırın
curl https://api.hiccup.dev/marketplace/catalog?page=1&size=50 \
  -H "Authorization: Bearer $TOKEN"

Her yerde aynı kurallar.

Üç API de tek bir ekip tarafından tek bir platformda geliştirilir. Birini entegre ederken öğrendikleriniz diğerlerinde de geçerlidir.

Sayfalama

Merchant ve Marketplace

Listeler page (1'den başlar) ve size alır; data ile birlikte meta.page, meta.size, meta.totalPages ve meta.totalCount döndürür.

Artımlı senkronizasyon

Marketplace

Her akış updatedSince (ISO-8601) kabul eder ve updatedOn alanına göre sıralanır. Sakladığınız en yeni updatedOn ile sorgulayın; tablonun tamamını hiçbir zaman yeniden okumazsınız.

Hesap kapsamı

Tüm API'ler

Token her isteği sizin hesabınızla sınırlar. Satıcı, kanal ya da depo kimliğinizi kendiniz göndermezsiniz ve kapsamınız dışındaki hiçbir şey okunamaz ya da değiştirilemez.

İstek sınırları

Tüm API'ler

Sınırlar token başına dakika bazındadır ve her uç noktada yazılıdır. 429 yanıtı, beklemeniz ve dakika dolduktan sonra tekrar denemeniz gerektiği anlamına gelir.

Hatalar

Tüm API'ler

Hatalar bir message ve bir kod içeren JSON'dur. Toplu uç noktalar hiçbir şeyi değiştirmeden önce her öğeyi doğrular. Tam yapı API'ye göre değişir; entegre ettiğiniz referansı okuyun.

Barkodlar ve SKU'lar

Tüm API'ler

Merchant ve Warehouse istekleri ürünün üzerindeki barkodu alır ve SKU'ya çözümler. Marketplace satırları familySku (ürün), skuPrefix (renk seçeneği) ve sku (beden) taşır.