GELİŞTİRİCİ API
Bıçak izlerini kendi yazılımınızdan üretin
Packdroid Geliştirici API'si bir şablon kodu ve ölçüleri alır, üretime hazır bıçak izini SVG, PDF veya DXF dosyası olarak döndürür; editörden indirilen dosyanın aynısı. Bıçak izlerini bir web-to-print mağazasına, ERP iş emrine veya teklif aracına bağlamak için kullanılır.
Nasıl çalışır
- Şablonları listeleyin
GET /api/v1/catalogue, etkin her şablonu genel kodu, adı ve parametre adlarıyla döndürür. q ve category ile filtreleyin; limit ve cursor ile sayfalayın.
- Bir şablonun şemasını okuyun
GET /api/v1/catalogue/{code}, her parametreyi birimi, varsayılanı, adımı ve en küçük/en büyük kurallarıyla döndürür; başka bir ölçüye bağlı kurallar da dahil. Seçenekler, sayfalar ve biçimler de gelir.
- Dosyayı üretin
POST /api/v1/dielines/{code} isteğini biçim ve parametrelerle gönderin. Yanıtın gövdesi doğrudan dosyadır; dosya adı ve şablon sürümü başlıklarda gelir.
Erişim ve anahtarlar
Geliştirici API'si Bench, Workshop ve Line planlarına dahildir. Anahtarları Hesap → Geliştirici API bölümünden oluşturup iptal edebilirsiniz. Anahtarın tamamı yalnızca bir kez gösterilir; Packdroid yalnızca özetini saklar. Bir hesapta en fazla beş etkin anahtar bulunabilir.
Anahtarı her istekte Bearer belirteci olarak gönderin. Anahtar sunucunuzda kalmalı: tarayıcı veya uygulama koduna koymayın, açığa çıkarsa iptal edin. Her sistem için ayrı anahtar kullanırsanız bir entegrasyonu diğerlerini etkilemeden durdurabilirsiniz.
Örnek istek
Şablonları listeleyin, ardından bir şablonun parametrelerini okuyun:
curl 'https://packdroid.com/api/v1/catalogue?limit=50' \
--header 'Authorization: Bearer pd_live_your_secret'
curl 'https://packdroid.com/api/v1/catalogue/PD-TL02' \
--header 'Authorization: Bearer pd_live_your_secret'4 mm mukavvadan 250 × 200 × 150 mm FEFCO 0201 koli, SVG olarak kaydediliyor:
curl --request POST \
'https://packdroid.com/api/v1/dielines/FEFCO%200201' \
--header 'Authorization: Bearer pd_live_your_secret' \
--header 'Content-Type: application/json' \
--output dieline.svg \
--data '{"format":"svg","parameters":{"length":250,"width":200,"depth":150,"corrugated_thickness":4}}'Ne döner
SVG ve PDF 1:1 fiziksel ölçekte çizilir; kesim ve kırım çizgileri ayrı katmanlardadır. Ölçü açıklamalarını veya bilgi panelini dimensions ve info alanlarıyla ekleyebilirsiniz. CAD ve kesim masaları için DXF de alınabilir.
Çok sayfalı şablonlar (örneğin sert kutunun mukavvası ve kaplaması) tek bir PDF, DXF dosyalarından oluşan bir ZIP veya birleşik ya da sayfalara ayrılmış SVG olarak döner. Birimler şablona göredir: ölçülerin çoğu milimetre, bazı malzeme kalınlıkları mikrometredir.
Sınırlar
Başarılı her dosya planın aylık indirme hakkından düşer. Bundan ayrı olarak her planın hizmeti koruyan işletim sınırları vardır; yanıtlar X-RateLimit başlıklarını, 429 yanıtları Retry-After başlığını taşır.
| Plan | Aylık indirme | Dakikada istek | Günde istek |
|---|---|---|---|
| Bench | 45 | 10 | 200 |
| Workshop | 90 | 20 | 1.000 |
| Line | Sınırsız | 30 | 5.000 |
Her anahtar aynı anda en fazla iki çizim çalıştırır ve bir çizim 30 saniyede zaman aşımına uğrar. Sınırlarını sürekli aşan bir anahtar 15 dakika askıya alınır; geçersiz istekler aylık haktan düşülmeden reddedilir.
Hatalar
Hatalar sabit bir code alanı taşıyan JSON'dur. Doğrulama hataları her sorunu konumuyla (örneğin parameters.length) ve aşılan en küçük veya en büyük değerle listeler.
| Durum | Anlamı |
|---|---|
| 400 | Bozuk JSON veya hatalı istek biçimi. İsteği düzeltin; yeniden denemeyin. |
| 401 | Anahtar eksik, geçersiz, iptal edilmiş veya süresi dolmuş. |
| 403 | Hesabın planı API erişimini veya indirmeyi kapsamıyor. |
| 404 | Bu koda sahip etkin şablon yok. Kataloğu yenileyin. |
| 422 | Bir parametre veya kombinasyon reddedildi. issues alanını okuyun. |
| 429 | İstek veya eşzamanlılık sınırı. Retry-After süresinden sonra deneyin. |
| 504 | Çizim 30 saniyeden uzun sürdü. Artan aralıklarla yeniden deneyin. |
Başlayın
Ücretli bir plan seçin, ardından Hesap → Geliştirici API bölümünden bir anahtar oluşturun. Entegrasyonla ilgili sorularınız için bize yazın.