Kumpix API

أنشئ نماذج مجوهرات ثلاثية الأبعاد بمقاسات دقيقة باستخدام قوالب Kumpix من موقعك أو برنامجك الخاص. يبني المحرك الحقيقي كل نموذج ويعيد وزنه وأحجاره وأبعاده وملف GLB.

إنشاء مفتاح API

المصادقة

يحمل كل طلب الترويسة Authorization: Bearer KPXA-…. أنشئ المفتاح من الحساب ← API واحفظه على خادمك فقط؛ لا تضعه في كود المتصفح.

نقاط النهاية

`GET`	`/v1/templates`	القوالب ومعاملاتها: أسماء الحقول والخيارات والحدود.
`POST`	`/v1/models`	يبني نموذجًا من قالب ويعيد الوزن وعدد الأحجار والأبعاد ورابط GLB. رصيد واحد؛ والنموذج الذي أُنشئ سابقًا بالإعدادات نفسها مجاني.
`GET`	`/v1/models/<id>.glb`	ملف GLB للنموذج (المحور Y للأعلى، بالأمتار؛ بالحجم الحقيقي في الواقع المعزز).
`GET`	`/v1/credits`	الرصيد المتبقي: رصيد خطتك لهذا الشهر وباقاتك.

مثال على طلب

curl -X POST https://motor.kumpix.com/v1/models \
  -H "Authorization: Bearer KPXA-…" \
  -H "Content-Type: application/json" \
  -d '{"type": "band", "params": {"width": 4, "ring_size": "US 7", "metal": "18k_gold"}}'

مثال على استجابة

{
  "id": "5f1c0a9e7b2d4c6e8a0b1c2d",
  "type": "band",
  "metal": "18k_gold",
  "grams": 4.12,
  "stones": 0,
  "dimensions": { "width_mm": 4.0, "inner_diameter_mm": 17.35 },
  "model": "https://motor.kumpix.com/v1/models/5f1c0a9e7b2d4c6e8a0b1c2d.glb",
  "charged": true,
  "credits_left": 299
}

رموز الأخطاء

`400`	قالب أو معامل غير صالح؛ توضح الرسالة في الاستجابة السبب.
`401`	لا يوجد مفتاح، أو المفتاح غير صالح، أو لا توجد خطة نشطة في حسابه.
`402`	الرصيد غير كافٍ؛ يمكنك شراء باقة أرصدة من حسابك.
`429`	تم تجاوز حد 60 طلبًا في الدقيقة لكل مفتاح.

الحدود والتكلفة

حتى 60 طلبًا في الدقيقة لكل مفتاح. أسعار الأرصدة والخطط في صفحة الأسعار. الأسعار