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.
Dakikalar içinde mağazanızı kendi yazılımınıza, Blender eklentinize veya yapay zeka asistanınıza bağlayın.
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.
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.
Ö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.
Tüm API isteklerinde API anahtarınızı HTTP Header (Başlık) içerisinde göndermeniz gerekir. İki yöntemden birini seçebilirsiniz:
API anahtarı oluştururken ihtiyacınıza göre yetki seçebilirsiniz:
| Yetki (Scope) | Varsayılan | Hız Limiti | Yapılabilecek İşlemler |
|---|---|---|---|
| read | Evet (Seçili Gelir) | 120 / min | Mağaza profilini, ürünleri, ürün detaylarını, kategorileri ve koleksiyonları listeleme |
| write | İsteğe Bağlı Seçilir | 30 / min | Yeni ürün oluşturma, mevcut ürünü güncelleme, versiyon ekleme ve ürün silme |
| upload | Write Yetkisiyle Aktif | 15 / min | 3D model (.stl, .3mf, .obj, .step, .zip) ve görsel/video dosyası yükleme (maks. 500 MB) |
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.
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())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.
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."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."
"3DLigo mağazamdaki tüm yayındaki ürünleri listele ve fiyatı 100 TL üzerindeki tüm ürünlere %20 indirim (discount_price) uygula."
"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 uç noktalar yalnızca API anahtarınızın bağlı olduğu mağaza üzerinde işlem yapar.
/api/v1/developer/storeAPI 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.
{
"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"]
}
}
}/api/v1/developer/categoriesÜrün yüklerken veya güncellerken kullanabileceğiniz tüm aktif 3DLigo kategori ID ve slug listesini döndürür.
{
"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
}
]
}/api/v1/developer/collectionsMağazanıza ait özel koleksiyonları listeler. Ürün oluştururken collection_ids alanına bu ID'leri gönderebilirsiniz.
{
"success": true,
"data": [
{
"id": 12,
"title": "2026 Mech Series",
"slug": "2026-mech-series"
}
]
}/api/v1/developer/productsMağazanızın ürünlerini sayfalanmış olarak listeler. Durum (status) ve arama kelimesine (q) göre filtrelenebilir.
pageintegerlimitintegerstatusstringqstring{
"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
}
}
}/api/v1/developer/products/:idMağ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.
{
"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"
}
]
}
}/api/v1/developer/files/uploadMultipart/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.
filefile (multipart)Zorunlucategorystring (form)Zorunlu{
"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"
}
}/api/v1/developer/products/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.
{
"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
}
]
}{
"success": true,
"data": {
"id": 1042,
"title": "Articulated Crystal Dragon v2",
"slug": "articulated-crystal-dragon-v2-1731628900",
"status": "published",
"message": "Product created successfully"
}
}/api/v1/developer/products/:idMağazanıza ait mevcut bir ürünün başlık, açıklama, fiyat, indirimli fiyat, durum, kategori, etiket veya dosya listesini günceller.
{
"title": "Articulated Crystal Dragon v2.1 (Enhanced Hinges)",
"price": 149.90,
"discount_price": 79.90,
"status": "published",
"tags": ["dragon", "articulated", "bambu-studio"]
}{
"success": true,
"data": {
"id": 1042,
"message": "Product updated successfully"
}
}/api/v1/developer/products/:id/versionsMevcut 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.
{
"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
}
]
}{
"success": true,
"data": {
"version_id": 315,
"product_id": 1042,
"version_number": "2.1.0",
"message": "New product version published"
}
}/api/v1/developer/products/:idMağ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.
{
"success": true,
"data": {
"id": 1042,
"action": "deleted",
"message": "Product removed successfully"
}
}İstek başarıyla tamamlandı.
Eksik/hatalı JSON verisi, desteklenmeyen dosya formatı veya URL içinde gönderilen API anahtarı.
API anahtarı eksik, hatalı, süresi dolmuş veya iptal edilmiş.
Anahtarın bu işlem için yetkisi yok (ör. write yetkisi seçilmemiş) veya IP kısıtlaması.
Dosya boyutu 500 MB sınırını aşıyor veya mağaza depolama kotası dolu.
Dakikalık istek limiti aşıldı. Retry-After başlığındaki süre kadar bekleyin.