3DLIGO GELİŞTİRİCİ API & YAPAY ZEKA ENTEGRASYONU

Mağazanızı Kodla veya Yapay Zeka ile Otomatize Edin

3DLigo REST API ile kendi mağazanıza ait 3D modelleri (.stl, .3mf, .obj, .step vb.) toplu olarak yükleyebilir, ürünlerinizi güncelleyebilir, yeni versiyonlar yayınlayabilir veya Cursor, Claude ve ChatGPT gibi yapay zeka araçlarını mağazanıza bağlayabilirsiniz.

Ana API Adresi (Base URL)REST JSON / Multipart
https://3dligo.com/api/v1/developer
Kimlik Doğrulama
Bearer Token / X-API-Key
Varsayılan Yetki
Read (Okuma)
Yükleme & Güncelleme
Write (Yazma - İsteğe Bağlı)
Desteklenen Formatlar
STL, 3MF, OBJ, STEP, ZIP + Görsel

3 Adımda Nasıl Kullanılır?

Dakikalar içinde mağazanızı kendi yazılımınıza, Blender eklentinize veya yapay zeka asistanınıza bağlayın.

01

1. API Anahtarınızı Oluşturun

store.3dligo.com/settings sayfasındaki "API & Developers" sekmesine gidin. Varsayılan olarak "Read (Okuma)" seçilidir; ürün yüklemek ve güncellemek istiyorsanız "Write (Yazma)" kutucuğunu da işaretleyip anahtarınızı oluşturun.

02

2. HTTP Başlığına (Header) Ekleyin

Oluşturduğunuz ligo_live_... anahtarını kopyalayın ve yapacağınız HTTP isteklerinde "Authorization: Bearer API_KEY" veya "X-API-Key: API_KEY" başlığı olarak gönderin.

03

3. Model Yükleyin ve Ürün Yönetin

Önce 3D model ve kapak görsellerinizi /files/upload uç noktasına yükleyin, ardından dönen dosya yollarıyla /products üzerinden ürününüzü oluşturun veya güncelleyin.

Kimlik Doğrulama (Authentication)

Tüm API isteklerinde API anahtarınızı HTTP Header (Başlık) içerisinde göndermeniz gerekir. İki yöntemden birini seçebilirsiniz:

Yöntem 1 — Authorization Bearer (Önerilen)
Authorization: Bearer ligo_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Yöntem 2 — X-API-Key Başlığı
X-API-Key: ligo_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠ Önemli Kural: API Anahtarını URL İçinde GöndermeyinGüvenliğiniz için ?api_key=... gibi URL query parametreleriyle gönderilen anahtarlar kabul edilmez (400 Bad Request döner). Anahtarınızı her zaman HTTP Header içinde gönderin.

Yetki İzinleri (Scopes) ve Hız Limitleri

API anahtarı oluştururken ihtiyacınıza göre yetki seçebilirsiniz:

Yetki (Scope)VarsayılanHız LimitiYapılabilecek İşlemler
readEvet (Seçili Gelir)120 / minMağaza profilini, ürünleri, ürün detaylarını, kategorileri ve koleksiyonları listeleme
writeİsteğe Bağlı Seçilir30 / minYeni ürün oluşturma, mevcut ürünü güncelleme, versiyon ekleme ve ürün silme
uploadWrite Yetkisiyle Aktif15 / min3D model (.stl, .3mf, .obj, .step, .zip) ve görsel/video dosyası yükleme (maks. 500 MB)

Popüler Programlama Dillerinde Kullanım Örnekleri

Kullandığınız programlama dilini seçerek ürün listeleme, 3D model yükleme ve ürün oluşturma kodlarını doğrudan projenize kopyalayın.

Python — Python (requests) veya Blender Python eklentileri ile mağazanıza otomatik 3D model yükleme ve ürün yönetimi:
import os
import requests

BASE_URL = "https://3dligo.com/api/v1/developer"
API_KEY = os.environ.get("LIGO_API_KEY", "ligo_live_YOUR_API_KEY")

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Accept": "application/json",
}

# 1. Mağaza Ürünlerini Listele (GET /products)
products_res = requests.get(f"{BASE_URL}/products", headers=headers, params={"limit": 20})
print("Store Products:", products_res.json())

# 2. 3D Model Dosyasını Yükle (POST /files/upload)
with open("crystal_dragon_v2.3mf", "rb") as f:
    model_res = requests.post(
        f"{BASE_URL}/files/upload",
        headers=headers,
        data={"category": "models"},
        files={"file": ("crystal_dragon_v2.3mf", f, "application/octet-stream")},
    )
model_data = model_res.json()["data"]

# 3. Kapak Görselini Yükle (POST /files/upload)
with open("cover_render.webp", "rb") as f:
    img_res = requests.post(
        f"{BASE_URL}/files/upload",
        headers=headers,
        data={"category": "images"},
        files={"file": ("cover_render.webp", f, "image/webp")},
    )
img_data = img_res.json()["data"]

# 4. Yeni Ürünü Yayınla (POST /products)
payload = {
    "title": "Articulated Crystal Dragon v2",
    "description": "<p>High-detail print-in-place crystal dragon.</p>",
    "price": 149.90,
    "discount_price": 99.90,
    "category_id": 1,
    "sku": "CFD-DRG-002",
    "status": "published",
    "tags": ["dragon", "articulated", "stl", "3mf"],
    "files": [
        {
            "file_url": model_data["path"],
            "file_type": "model",
            "display_name": model_data["original_name"],
            "file_size_kb": model_data["size_kb"],
            "is_primary": True,
        },
        {
            "file_url": img_data["url"],
            "file_type": "image",
            "display_name": img_data["original_name"],
            "file_size_kb": img_data["size_kb"],
            "is_primary": True,
        },
    ],
}

create_res = requests.post(f"{BASE_URL}/products", headers=headers, json=payload)
print("Created Product:", create_res.json())
✨ YAPAY ZEKA (AI) OTOMASYONU

Yapay Zeka Araçlarını Bağlayın (ChatGPT, Claude, Cursor, Copilot)

Kod yazmak istemiyor musunuz? Aşağıdaki hazır yapay zeka komutunu (Prompt) kopyalayıp Cursor, Claude Code, ChatGPT veya Windsurf'e yapıştırarak mağazanızı doğal dille yönetebilirsiniz.

🤖 Cursor AI🤖 Claude / Claude Code🤖 ChatGPT (GPT-4o / o3)🤖 GitHub Copilot🤖 Windsurf🤖 n8n / Make AI Agent

Yapay Zeka ile Nasıl Kullanılır?

STEP 1Mağaza Ayarları (store.3dligo.com/settings) sayfasından "Read" ve "Write" yetkili bir API Key oluşturun.
STEP 2Aşağıdaki "Hazır AI Sistem Promptu"nu kopyalayıp kullandığınız yapay zeka aracına (Cursor, Claude, ChatGPT vb.) yapıştırın.
STEP 3Yapay zekaya ne yapmak istediğinizi Türkçe veya istediğiniz dilde yazın (ör. "Klasördeki tüm STL modellerini mağazama yükle").
Kopyalanabilir Hazır AI Sistem Promptu (Cursor / Claude / ChatGPT)
You are connected to my 3DLigo 3D Model Store via the official 3DLigo Developer REST API.

### API Configuration
- Base URL: https://3dligo.com/api/v1/developer
- Authentication Header: Authorization: Bearer <MY_3DLIGO_API_KEY> (or X-API-Key: <MY_3DLIGO_API_KEY>)
- Never send the API key in URL query parameters.

### Available Endpoints
1. GET /store -> Returns store info and storage quota.
2. GET /categories -> Returns marketplace category IDs and slugs.
3. GET /collections -> Returns my store's collection IDs.
4. GET /meta-tags -> Returns printer, filament, and part tags.
5. GET /products?page=1&limit=20&status=published&q=keyword -> Lists my store's products.
6. GET /products/:id -> Returns full details, files, and versions of product :id.
7. POST /files/upload (multipart/form-data)
   - Form fields: "category" ("models" for .stl/.3mf/.obj/.step/.zip or "images" for .webp/.png/.jpg) and "file" (binary file).
   - Returns: { "data": { "path": "...", "url": "...", "original_name": "...", "size_kb": 1234 } }
8. POST /products (application/json)
   - Body: {
       "title": "String (required)",
       "description": "HTML or text description",
       "price": 149.90,
       "discount_price": 99.90,
       "category_id": 1,
       "sku": "OPTIONAL-SKU",
       "status": "published", // or "draft"
       "license_type": "personal", // or "commercial"
       "tags": ["tag1", "tag2"],
       "files": [
         { "file_url": "<path from /files/upload>", "file_type": "model", "display_name": "model.3mf", "file_size_kb": 1234, "is_primary": true },
         { "file_url": "<url from /files/upload>", "file_type": "image", "display_name": "cover.webp", "file_size_kb": 200, "is_primary": true }
       ]
     }
9. PUT /products/:id (application/json) -> Updates title, description, price, discount_price, status, category_id, tags, or files.
10. POST /products/:id/versions (application/json) -> Publishes a new version: { "version_number": "2.0.0", "changelog": "Release notes", "files": [...] }
11. DELETE /products/:id -> Deletes or archives product :id.

My 3DLigo API Key is: ligo_live_PASTE_YOUR_KEY_HERE
Please help me automate my store tasks using these endpoints.

Yapay Zekaya Verebileceğiniz Örnek Komutlar

Toplu 3D Model Yükleme

"Masaüstümdeki /Modellerim klasöründe bulunan tüm .3mf ve .stl dosyalarını kapak fotoğraflarıyla birlikte 3DLigo mağazama 149.90 TL fiyatla yükle ve yayınla."

Toplu Fiyat ve İndirim Güncelleme

"3DLigo mağazamdaki tüm yayındaki ürünleri listele ve fiyatı 100 TL üzerindeki tüm ürünlere %20 indirim (discount_price) uygula."

Yeni Versiyon Yayınlama

"Mağazamdaki 'Crystal Dragon' ürününü bul, yeni hazırladığım dragon_v2_fixed.3mf dosyasını yükle ve v2.0.0 sürüm notuyla ürüne yeni versiyon olarak ekle."

Tüm API Uç Noktaları (Endpoints)

Tüm uç noktalar yalnızca API anahtarınızın bağlı olduğu mağaza üzerinde işlem yapar.

GET/api/v1/developer/store
Scope: read120 req/min

Mağaza Bilgileri ve Depolama Kotası

API anahtarının bağlı olduğu mağazanın bilgilerini, onay durumunu, toplam ürün sayısını ve kalan depolama kotasını döndürür.

Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "store_id": 42,
    "name": "CyberForge 3D Studio",
    "slug": "cyberforge-3d-studio",
    "description": "High-detail sci-fi miniatures and terrain",
    "status": "approved",
    "is_verified": true,
    "product_count": 128,
    "storage": {
      "used_kb": 1458200,
      "quota_kb": 52428800,
      "used_percent": 2.78
    },
    "api_key": {
      "scopes": ["read", "write"]
    }
  }
}
GET/api/v1/developer/categories
Scope: read120 req/min

Kategorileri Listele

Ürün yüklerken veya güncellerken kullanabileceğiniz tüm aktif 3DLigo kategori ID ve slug listesini döndürür.

Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Miniatures & Tabletop",
      "slug": "miniatures-tabletop",
      "parent_id": null
    },
    {
      "id": 5,
      "name": "Cosplay & Props",
      "slug": "cosplay-props",
      "parent_id": null
    }
  ]
}
GET/api/v1/developer/collections
Scope: read120 req/min

Mağaza Koleksiyonlarını Listele

Mağazanıza ait özel koleksiyonları listeler. Ürün oluştururken collection_ids alanına bu ID'leri gönderebilirsiniz.

Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": [
    {
      "id": 12,
      "title": "2026 Mech Series",
      "slug": "2026-mech-series"
    }
  ]
}
GET/api/v1/developer/meta-tags
Scope: read120 req/min

Yazıcı, Filament ve Parça Etiketlerini Listele

Ürünlerinize ekleyebileceğiniz uyumlu 3D yazıcı modelleri, filament tipleri (PLA, PETG, ABS, Resin vb.) ve parça etiketlerini döndürür.

Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "printers": [{ "id": 1, "name": "Bambu Lab X1C", "slug": "bambu-lab-x1c" }],
    "filaments": [{ "id": 10, "name": "PLA+", "slug": "pla-plus" }],
    "parts": [{ "id": 22, "name": "No Supports Required", "slug": "no-supports" }]
  }
}
GET/api/v1/developer/products
Scope: read120 req/min

Mağaza Ürünlerini Listele

Mağazanızın ürünlerini sayfalanmış olarak listeler. Durum (status) ve arama kelimesine (q) göre filtrelenebilir.

Parametreler
pageinteger
Sayfa numarası (varsayılan: 1)
limitinteger
Sayfa başına kayıt (varsayılan: 20, maks: 100)
statusstring
Durum filtresi: published, draft, pending, archived
qstring
Ürün başlığı veya SKU içinde arama yapar
Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 1042,
        "title": "Articulated Crystal Dragon v2",
        "slug": "articulated-crystal-dragon-v2",
        "sku": "CFD-DRG-002",
        "price": 149.9,
        "discount_price": 99.9,
        "status": "published",
        "thumbnail": "https://cdn.3dligo.com/public/stores/42/images/cover.webp",
        "downloads": 384,
        "views": 4910,
        "category_id": 1,
        "license_fee": 0,
        "created_at": "2026-11-10T14:22:00Z",
        "updated_at": "2026-11-14T19:05:11Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "total_pages": 1
    }
  }
}
GET/api/v1/developer/products/:id
Scope: read120 req/min

Ürün Detayı, Dosyalar ve Versiyonlar

Mağazanıza ait tek bir ürünün tüm detaylarını, yüklenmiş 3D model dosyalarını, görsellerini, etiketlerini ve versiyon geçmişini döndürür.

Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "id": 1042,
    "title": "Articulated Crystal Dragon v2",
    "slug": "articulated-crystal-dragon-v2",
    "description": "<p>Print-in-place articulated dragon. No supports needed.</p>",
    "sku": "CFD-DRG-002",
    "price": 149.9,
    "discount_price": 99.9,
    "status": "published",
    "category_id": 1,
    "tags": ["dragon", "articulated", "print-in-place"],
    "files": [
      {
        "id": 8801,
        "file_type": "model",
        "display_name": "crystal_dragon_v2.3mf",
        "file_size_kb": 18420,
        "is_primary": true
      },
      {
        "id": 8802,
        "file_type": "image",
        "display_name": "cover_render.webp",
        "file_url": "https://cdn.3dligo.com/public/stores/42/images/cover_render.webp",
        "is_primary": true
      }
    ],
    "versions": [
      {
        "id": 310,
        "version_number": "1.0.0",
        "changelog": "Initial release",
        "created_at": "2026-11-10T14:22:00Z"
      }
    ]
  }
}
POST/api/v1/developer/files/upload
Scope: write15 req/min

3D Model veya Görsel Dosyası Yükle

Multipart/form-data olarak 3D model (.stl, .obj, .3mf, .step, .stp, .iges, .igs, .fbx, .gltf, .glb, .blend, .gcode, .amf, .ply, .dae, .scad, .f3d, .zip, .rar, .7z) veya görsel/video (.jpg, .png, .webp, .gif, .mp4, .webm, .pdf) yükler. Dönen path/url değerini ürün oluştururken veya güncellerken files dizisinde kullanabilirsiniz.

Parametreler
filefile (multipart)Zorunlu
Yüklenecek dosya (Maks: 500 MB)
categorystring (form)Zorunlu
"models" (3D baskı dosyaları) veya "images" (kapak/galeri görselleri)
Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "path": "private/stores/42/models/a91f38c2_crystal_dragon_v2.3mf.enc",
    "url": "private/stores/42/models/a91f38c2_crystal_dragon_v2.3mf.enc",
    "original_name": "crystal_dragon_v2.3mf",
    "size_kb": 18420,
    "category": "models"
  }
}
POST/api/v1/developer/products
Scope: write30 req/min

Yeni Ürün Oluştur

/api/v1/developer/files/upload ile yüklediğiniz model ve görselleri bağlayarak mağazanızda yeni bir 3D model ürünü oluşturur.

Örnek İstek Gövdesi (Request JSON)
{
  "title": "Articulated Crystal Dragon v2",
  "description": "<p>High-detail print-in-place crystal dragon. Tested on Bambu Lab X1C & Prusa MK4.</p>",
  "price": 149.90,
  "discount_price": 99.90,
  "category_id": 1,
  "sku": "CFD-DRG-002",
  "status": "published",
  "is_ai_generated": false,
  "license_type": "personal",
  "license_fee": 0,
  "tags": ["dragon", "articulated", "fantasy", "print-in-place"],
  "collection_ids": [12],
  "files": [
    {
      "file_url": "private/stores/42/models/a91f38c2_crystal_dragon_v2.3mf.enc",
      "file_type": "model",
      "display_name": "crystal_dragon_v2.3mf",
      "file_size_kb": 18420,
      "is_primary": true
    },
    {
      "file_url": "https://cdn.3dligo.com/public/stores/42/images/cover_render.webp",
      "file_type": "image",
      "display_name": "cover_render.webp",
      "file_size_kb": 420,
      "is_primary": true
    }
  ]
}
Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "id": 1042,
    "title": "Articulated Crystal Dragon v2",
    "slug": "articulated-crystal-dragon-v2-1731628900",
    "status": "published",
    "message": "Product created successfully"
  }
}
PUT/api/v1/developer/products/:id
Scope: write30 req/min

Ürünü Güncelle

Mağazanıza ait mevcut bir ürünün başlık, açıklama, fiyat, indirimli fiyat, durum, kategori, etiket veya dosya listesini günceller.

Örnek İstek Gövdesi (Request JSON)
{
  "title": "Articulated Crystal Dragon v2.1 (Enhanced Hinges)",
  "price": 149.90,
  "discount_price": 79.90,
  "status": "published",
  "tags": ["dragon", "articulated", "bambu-studio"]
}
Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "id": 1042,
    "message": "Product updated successfully"
  }
}
POST/api/v1/developer/products/:id/versions
Scope: write30 req/min

Ürüne Yeni Versiyon Ekle

Mevcut bir ürüne yeni bir sürüm (ör. v2.1.0) ve sürüm notları (changelog) ekler, isteğe bağlı olarak yeni yüklenen 3D model dosyalarını bu sürüme bağlar.

Örnek İstek Gövdesi (Request JSON)
{
  "version_number": "2.1.0",
  "changelog": "Strengthened tail joints and added pre-supported Chitubox resin file.",
  "files": [
    {
      "file_url": "private/stores/42/models/f82b19d4_dragon_v2_1_resin.3mf.enc",
      "file_type": "model",
      "display_name": "dragon_v2_1_resin.3mf",
      "file_size_kb": 24100,
      "is_primary": false
    }
  ]
}
Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "version_id": 315,
    "product_id": 1042,
    "version_number": "2.1.0",
    "message": "New product version published"
  }
}
DELETE/api/v1/developer/products/:id
Scope: write30 req/min

Ürünü Sil / Arşivle

Mağazanıza ait bir ürünü siler. Daha önce satın alınmışsa müşteri erişimini korumak için arşivler, aksi halde tamamen kaldırır.

Örnek Yanıt (Response JSON)
{
  "success": true,
  "data": {
    "id": 1042,
    "action": "deleted",
    "message": "Product removed successfully"
  }
}

HTTP Durum ve Hata Kodları

200 / 201 OK

İstek başarıyla tamamlandı.

400 Bad Request

Eksik/hatalı JSON verisi, desteklenmeyen dosya formatı veya URL içinde gönderilen API anahtarı.

401 Unauthorized

API anahtarı eksik, hatalı, süresi dolmuş veya iptal edilmiş.

403 Forbidden

Anahtarın bu işlem için yetkisi yok (ör. write yetkisi seçilmemiş) veya IP kısıtlaması.

413 / 507 Quota

Dosya boyutu 500 MB sınırını aşıyor veya mağaza depolama kotası dolu.

429 Too Many Requests

Dakikalık istek limiti aşıldı. Retry-After başlığındaki süre kadar bekleyin.