أنشئ ملفات الداي كت من برنامجك

طريقة العمل

1. اعرض القوالب

   يعيد GET /api/v1/catalogue كل قالب نشط برمزه العام واسمه وأسماء معلماته. صفِّ النتائج بـ q وcategory، وتنقّل بين الصفحات بـ limit وcursor.

2. اقرأ مواصفات قالب واحد

   يعيد GET /api/v1/catalogue/{code} كل معلمة مع وحدته وقيمته الافتراضية وخطوته وقواعد الحد الأدنى والأقصى، بما فيها القواعد التي تعتمد على مقاس آخر، إضافة إلى الخيارات والصفحات والصيغ.

3. أنشئ الملف

   أرسل POST /api/v1/dielines/{code} مع الصيغة والمعلمات. جسم الاستجابة هو الملف نفسه، واسم الملف وإصدار القالب في الترويسات.

الوصول والمفاتيح

واجهة المطوّرين مشمولة في خطط Bench وWorkshop وLine. أنشئ المفاتيح وألغِها من الحساب ← واجهة المطوّرين. يظهر المفتاح كاملًا مرة واحدة فقط، ولا يحفظ Packdroid إلا بصمته. يمكن للحساب الاحتفاظ بخمسة مفاتيح نشطة.

أرسل المفتاح رمزَ Bearer في كل طلب. احتفظ به على خادمك: لا تضعه في شيفرة المتصفح أو التطبيق، وألغِه إن انكشف. استخدم مفتاحًا منفصلًا لكل نظام، حتى تتمكن من إيقاف تكامل واحد دون التأثير في غيره.

مثال على طلب

اعرض القوالب، ثم اقرأ معلمات قالب واحد:

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'

صندوق شحن FEFCO 0201 بمقاس 250 × 200 × 150 مم من كرتون 4 مم، محفوظ بصيغة SVG:

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}}'

ما الذي تحصل عليه

يُرسم SVG وPDF بمقياس 1:1 فعلي، وخطوط القص والطيّ في طبقات منفصلة. أضف تعليقات المقاسات أو لوحة المعلومات بالحقلين dimensions وinfo. وتتوفر صيغة DXF لبرامج CAD وطاولات القطع.

تعود القوالب متعددة الصفحات (مثل كرتون الهارد بوكس وغلافه) ملفَّ PDF واحدًا، أو ملف ZIP يضم ملفات DXF، أو SVG مجمّعًا أو مقسّمًا إلى صفحات. الوحدات بحسب القالب: معظم المقاسات بالمليمتر، وبعض سماكات الخامات بالميكرومتر.

الحدود

يُحتسب كل ملف ناجح من التنزيلات الشهرية للخطة. وإلى جانب ذلك، لكل خطة حدود تشغيلية تحمي الخدمة؛ تحمل الاستجابات ترويسات X-RateLimit، وتحمل استجابة 429 الترويسة Retry-After.

يشغّل كل مفتاح عمليتَي إنشاء على الأكثر في الوقت نفسه، وتنتهي مهلة الإنشاء بعد 30 ثانية. يُعلَّق المفتاح الذي يتجاوز حدوده مرارًا لمدة 15 دقيقة، وتُرفض الطلبات غير الصالحة قبل أن تُحتسب من الحصة الشهرية.

الأخطاء

الأخطاء بصيغة JSON مع رمز code ثابت. تسرد أخطاء التحقق كل مشكلة مع موضعها، مثل parameters.length، والحد الأدنى أو الأقصى الذي خالفته.

ابدأ

اختر خطة مدفوعة، ثم أنشئ مفتاحًا من الحساب ← واجهة المطوّرين. لأي سؤال عن التكامل، راسلنا.

عرض الخطط إنشاء مفتاح API تواصل معنا