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

  1. Ş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.

  2. 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.

  3. 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.

PlanAylık indirmeDakikada istekGünde istek
Bench4510200
Workshop90201.000
LineSınırsız305.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.

DurumAnlamı
400Bozuk JSON veya hatalı istek biçimi. İsteği düzeltin; yeniden denemeyin.
401Anahtar eksik, geçersiz, iptal edilmiş veya süresi dolmuş.
403Hesabın planı API erişimini veya indirmeyi kapsamıyor.
404Bu koda sahip etkin şablon yok. Kataloğu yenileyin.
422Bir 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.

Planları incele API anahtarı oluştur Bize ulaş