API BELGELERİ
Picklo'yu kendi sistemlerinize bağlayın.
Picklo API'si https://app.picklo.io/api/v1 adresinde çalışır. Erişim, panelden oluşturduğunuz API anahtarıyla alınan kısa ömürlü bir jetonla sağlanır.
HIZLI BAŞLANGIÇ
Dört adımda ilk sipariş.
- 1
API anahtarı oluşturun
Panelde API anahtarları ekranından yeni bir anahtar oluşturun ve ihtiyacınız olan yetki kapsamlarını seçin. Anahtar yalnız bir kez gösterilir.
- 2
Erişim jetonu alın
Anahtarı X-API-Key başlığıyla gönderin; kısa ömürlü bir erişim jetonu döner.
curl -X POST https://app.picklo.io/api/v1/token \ -H "X-API-Key: <api-anahtariniz>" - 3
Sipariş gönderin
source ve external_ref birlikte siparişin kimliğidir: aynı ikiliyle gelen sipariş ikinci kez işlenmez. Başarılı istek 201 döner.
curl -X POST https://app.picklo.io/api/v1/orders \ -H "Authorization: Bearer <jeton>" \ -H "Content-Type: application/json" \ -d '{"source": "magazam", "external_ref": "SIP-1001", "payload": { ... }}' - 4
Kargolanan siparişleri okuyun
Yanıt items ve next_cursor döner; sonraki sayfa için next_cursor değerini olduğu gibi geri gönderin.
curl "https://app.picklo.io/api/v1/fulfillments?since=2026-10-01T00:00:00Z&limit=50" \ -H "Authorization: Bearer <jeton>"
YETKİ KAPSAMLARI
Anahtar yalnız izin verdiğiniz işi yapar.
| Kapsam | İzin |
|---|---|
| orders:write | Sipariş gönderme |
| orders:read | Siparişleri ve kargolanan siparişleri okuma |
| inventory:read | Stok okuma |
| products:read | Ürün okuma |
| warehouses:read | Depo bilgisi okuma |
WEBHOOK
Sipariş kargolandığında haberiniz olsun.
Sipariş kargolandığında (order.fulfilled) tanımladığınız adrese bildirim gönderilir. İstek gövdesinin HMAC-SHA256 imzası X-WMS-Signature başlığında gelir; imzayı webhook sırrınızla doğrulayın. Ulaşılamayan bildirim 5 kez denenir.
- order.fulfilled olayı
- HMAC-SHA256 imza
- Panelden teslimat geçmişi
HEMEN BAŞLAYIN
Depo operasyonlarınızı
dijitalleştirmeye hazır mısınız?
Picklo ile e-ticaret ve perakende operasyonlarınızı dijitalleştirin, daha hızlı büyüyün.