Kumpix API

Kendi sitenizden ya da yazılımınızdan Kumpix şablonlarıyla ölçülü 3B takı modeli kurun. Her model gerçek motorla kurulur; gramı, taşları, ölçüleri ve GLB dosyası döner.

API anahtarı oluştur

Kimlik doğrulama

Her istek Authorization: Bearer KPXA-… başlığını taşır. Anahtarı Hesap → API sayfasında oluşturun ve yalnız sunucunuzda saklayın; tarayıcı koduna koymayın.

Uçlar

`GET`	`/v1/templates`	Şablonlar ve parametreleri: alan adları, seçenekler ve sınırlar.
`POST`	`/v1/models`	Şablondan model kurar; gram, taş sayısı, ölçüler ve GLB bağlantısı döner. 1 kredi; aynı ayarlarla daha önce kurulmuş model ücretsizdir.
`GET`	`/v1/models/<id>.glb`	Modelin GLB dosyası (Y yukarı, metre; AR'de gerçek boyut).
`GET`	`/v1/credits`	Kalan kredi: planınızın bu ayki kredisi ve paketler.

Örnek istek

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

Örnek yanıt

{
  "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
}

Hata kodları

`400`	Geçersiz şablon ya da parametre; yanıttaki mesaj nedenini söyler.
`401`	Anahtar yok, geçersiz ya da hesabında etkin plan yok.
`402`	Kredi yetmiyor; hesabınızdan kredi paketi alabilirsiniz.
`429`	Anahtar başına dakikada 60 istek sınırı aşıldı.

Sınırlar ve ücret

Anahtar başına dakikada en çok 60 istek. Kredi fiyatları ve planlar Fiyatlar sayfasındadır. Fiyatlandırma