PolyDrobe nasıl kullanılır?
Bir çalışma alanı kurun, varlıklarınızı ve varyantlarınızı modelleyin, ekibi davet edin ve en sık karşılaşılan hataları giderin.
Dört adımda çalışır durumda
Proje, taksonomi, varlıklar, ekip. Bu sırayla.
Proje oluştur
İlk projenizi oluşturun ve net bir proje slug belirleyin.
Taksonomiyi yapılandır
Kategoriler, nadirlikler, etiketler, para birimleri, durumlar ve sürümler ayarlarını yapın.
Varlık ve varyant ekle
Varlık ekleyin, ardından görseller, fiyat ve isteğe bağlı metadata ile varyantlar oluşturun.
Ekibinizi davet edin
Ekip üyelerini davet edin ve Sahip, Editör, Görüntüleyici rollerini atayın.
Yapabileceğiniz her şey
Ayrıntıları görmek için bir iş akışını açın.
Proje KurulumuÖnce yapı, sonra içerik.
- Proje detaylarını ve ikonunu tamamlayın.
- Proje ayarları içinde yeniden kullanılabilir taksonomi tanımlayın.
Varlık ve Varyant YönetimiVarlık ana öğeyi, varyant ise sürümü temsil eder.
- Varlık metadata'sı ekleyin ve kategori/nadirlik atayın.
- Varyantlara texture, görsel ve fiyat bilgisi ekleyin.
İnceleme ve AramaKataloğu okunabilir ve sürdürülebilir tutun.
- Önünüzdeki işi bulmak için filtreleri, durumu ve etiketleri kullanın.
- Değişiklikleri etkinlik günlüğünden kontrol edin.
İçe ve Dışa AktarmaPipeline ile veriyi güvenli şekilde paylaşın.
- Proje verisini JSON veya Excel olarak dışa aktarın; görselleri, texture'ları ve mesh'leri içeren bir ZIP paketi için Medya dosyalarını dahil et seçeneğini işaretleyin.
- JSON, Excel veya ZIP paketlerini içe aktarın. Her içe aktarma önce bir önizleme çalıştırır; böylece hiçbir şey kaydedilmeden önce satır düzeyindeki değişiklikleri ve hataları incelersiniz.
Google Sheets ile İçe AktarmaYerel bir Google E-Tablosu'ndan varlıkları, varyantları ve proje ayarlarını içe aktarın.
- Her kayıt türü için bir çalışma sayfası içeren yerel bir Google E-Tablosu oluşturun (yüklenmiş bir .xlsx değil): Currencies, Rarities, Releases, Tags, Categories, Assets, Variants.
- Her çalışma sayfasının ilk satırına sütun başlıklarını birebir yazın (büyük/küçük harf duyarlıdır). Örneğin Variants sayfası şunları ister: slug, name, asset_slug, rarity, release, currency, price, description, tags.
- Kayıtlar bağımlılık sırasına göre içe aktarılır: Currencies, Rarities, Releases, Tags, Categories, Assets ve en son Variants. Bir satırın başvurduğu her şey ya projede zaten var olmalı ya da aynı çalıştırmada daha önce gelmelidir.
- Projenizde Veri aktarımı sayfasını açın (proje menüsünde İçe / Dışa aktar), içe aktarma kaynağı olarak Google E-Tablosu'nu seçin ve Google hesabınızı bağlayın. PolyDrobe, Google'ın drive.file kapsamını ister; bu yüzden yalnızca kendisine verdiğiniz dosyaları okuyabilir.
- Profil oluştur bölümünde profile bir etiket verin, Google Picker'da e-tablonuzu seçmek için Gözat'a tıklayın, sekmelerinizin adları farklıysa çalışma sayfası adlarını düzenleyin ve Profili kaydet'e tıklayın.
- Önce kayıtlı profilde Önizleme'yi çalıştırın. Bu, hiçbir şey yazmadan doğrulama hatalarını bildiren bir test çalıştırmasıdır; İçe aktar ise aynı çalıştırmayı gerçekten uygular.
- Assets veya Variants sayfasındaki etiketler için değerleri noktalı virgülle ayırın: starter;seasonal=winter;limited-edition.
- Fiyatlar ondalık ayırıcı olarak hem noktayı hem virgülü kabul eder (9.99 veya 9,99). Nadirlik ada, para birimi koda, sürüm ise sürüm numarasına göre eşleştirilir.
Geliştirici kılavuzları
Araçlarınızı, yapay zekâ ajanlarınızı ve pipeline'larınızı PolyDrobe'a bağlayın.
REST API KurulumuStandart REST API ile PolyDrobe'a entegre olun. Pro planında kullanılabilir.
1. Erişim jetonu oluşturun
Çalışma alanı ayarları > API Jetonları sayfasına gidin ve yeni bir kişisel erişim jetonu oluşturun. Açıklayıcı bir ad verin (örneğin 'CI Pipeline' veya 'Local Script'), okuma ve yazma kapsamlarını seçin ve bir geçerlilik süresi belirleyin. Jeton ekranda göründüğünde kopyalayın, çünkü yalnızca bir kez gösterilir.
# Your token will look like this: pdtk_a8f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5... # Keep it safe. You cannot retrieve it later. # If lost, revoke it and create a new one.
2. İstekleri doğrulayın
Jetonu her istekte Authorization başlığında Bearer jetonu olarak gönderin.
curl -H "Authorization: Bearer pdtk_abc123..." \
https://polydrobe.app/api/v1/projects/
3. Projelerinizi listeleyin
Üyesi olduğunuz tüm projeleri döndürür. Yanıt, data ve meta anahtarlarını içeren standart zarf biçimini kullanır.
GET /api/v1/projects/
# Response:
{
"data": [
{
"id": "...",
"name": "Cyber Skins",
"slug": "cyber-skins",
"asset_count": 42,
"my_role": "owner"
}
],
"meta": { "total": 1, "page": 1, "page_size": 25 }
}
4. Varlık oluşturun
Bir projenin içinde varlık oluşturun. Editör veya Sahip rolü gerekir. Slug, addan otomatik üretilir.
curl -X POST \
-H "Authorization: Bearer pdtk_abc123..." \
-H "Content-Type: application/json" \
-d '{"name": "Plasma Rifle", "description": "Sci-fi weapon", "category_slug": "weapons"}' \
https://polydrobe.app/api/v1/projects/cyber-skins/assets/
5. Varyant oluşturun
Bir varlığa fiyat, nadirlik ve durum bilgisiyle varyant ekleyin. Tüm yabancı anahtar başvuruları slug kullanır.
curl -X POST \
-H "Authorization: Bearer pdtk_abc123..." \
-H "Content-Type: application/json" \
-d '{"name": "Gold Edition", "rarity_slug": "legendary", "price": "29.99", "currency_code": "USD"}' \
https://polydrobe.app/api/v1/projects/cyber-skins/assets/plasma-rifle/variants/
6. Varlıklarda arama yapın
PostgreSQL aramasıyla varlıklar ve varyantlar genelinde tam metin araması. Öbek arama, OR ve olumsuzlamayı destekler.
GET /api/v1/projects/cyber-skins/search/?q=gold+legendary&type=variant&limit=10
7. Toplu işlemler
Birden çok varyantı tek seferde güncelleyin veya silin. Pro planındaki Toplu işlemler yeteneğini gerektirir.
curl -X POST \
-H "Authorization: Bearer pdtk_abc123..." \
-H "Content-Type: application/json" \
-d '{"slugs": ["v1", "v2", "v3"], "updates": {"status_slug": "released"}}' \
https://polydrobe.app/api/v1/projects/cyber-skins/bulk/variants/update/
Kullanılabilir uç noktalar
REST API; PolyDrobe'un sakladığı her proje kaynağına, kataloğun kendisinden medyaya, toplu düzenlemelere, etkinlik günlüğüne ve webhook'lara kadar erişir. Aşağıdaki gruplar setin tamamıdır. Her kaynak slug tabanlı URL kullanır.
Projects: GET|POST /v1/projects/
GET|PATCH|DELETE /v1/projects/{slug}/
Assets: GET|POST /v1/projects/{slug}/assets/
GET|PATCH|DELETE /v1/projects/{slug}/assets/{slug}/
Variants: GET|POST /v1/projects/{slug}/assets/{slug}/variants/
GET|PATCH|DELETE .../assets/{slug}/variants/{slug}/
GET /v1/projects/{slug}/variants/ (flat list)
Media: GET .../variants/{slug}/images/
PATCH|DELETE .../variants/{slug}/images/{uuid}/
GET .../variants/{slug}/textures/
DELETE .../variants/{slug}/textures/{uuid}/
Bundles: GET|POST /v1/projects/{slug}/bundles/
GET|PUT|PATCH|DELETE /v1/projects/{slug}/bundles/{slug}/
GET|POST /v1/projects/{slug}/bundles/{slug}/items/
DELETE .../bundles/{slug}/items/{variant_slug}/
Collections: GET|POST /v1/projects/{slug}/collections/
GET|PUT|PATCH|DELETE .../collections/{slug}/
GET .../collections/{slug}/items/
POST .../collections/{slug}/members/
DELETE .../collections/{slug}/members/{variant_slug}/
POST .../collections/{slug}/duplicate/
Classification: GET|POST /v1/projects/{slug}/{categories|tags|rarities|releases|currencies|statuses}/
PATCH|DELETE /v1/projects/{slug}/{entity}/{slug}/
Favorites: GET /v1/projects/{slug}/favorites/
POST|PUT|DELETE /v1/projects/{slug}/favorites/{kind}/{uuid}/
Team: GET|POST /v1/projects/{slug}/members/
PATCH|DELETE /v1/projects/{slug}/members/{user_id}/
Bulk: POST /v1/projects/{slug}/bulk/variants/update/
POST /v1/projects/{slug}/bulk/variants/delete/
Search: GET /v1/projects/{slug}/search/?q=term&type=all
Activity: GET /v1/projects/{slug}/activity/
Export: GET /v1/projects/{slug}/export/?format=json
Webhooks: GET|POST /v1/projects/{slug}/webhooks/
PATCH|DELETE /v1/projects/{slug}/webhooks/{uuid}/
MCP Sunucusu KurulumuYapay zekâ asistanlarını (Claude, ChatGPT) Model Context Protocol ile PolyDrobe'a bağlayın. Pro planında kullanılabilir.
1. Kişisel erişim jetonu oluşturun
Çalışma alanı ayarları > API Jetonları sayfasına gidin ve yeni bir jeton oluşturun. Adını yapay zekâ istemcinize göre verin (örneğin 'Claude Desktop' veya 'Claude Code'). Okuma ve yazma kapsamlarını seçin ve uzun bir geçerlilik süresi belirleyin (1 yıl veya süresiz). Jeton ekranda göründüğünde kopyalayın, çünkü yalnızca bir kez gösterilir.
# Your token will look like this: pdtk_a8f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5... # Use this token in the configuration steps below. # The same token works for both REST API and MCP server.
2. Claude Desktop'ı bağlayın
PolyDrobe MCP sunucusunu Claude Desktop yapılandırmanıza ekleyin. claude_desktop_config.json dosyasını açın ve şu girdiyi ekleyin.
{
"mcpServers": {
"polydrobe": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://polydrobe.app/mcp"],
"env": {
"MCP_HEADERS": "Authorization: Bearer pdtk_abc123..."
}
}
}
}
3. Claude Code'u bağlayın
MCP sunucusunu terminalden Claude Code CLI ile ekleyin.
claude mcp add polydrobe \ --transport http \ --url https://polydrobe.app/mcp \ --header "Authorization: Bearer pdtk_abc123..."
4. Yerel geliştirme (stdio modu)
Yerel geliştirmede MCP sunucusunu HTTP olmadan doğrudan stdio üzerinden çalıştırın. Bu, belirttiğiniz kullanıcı olarak önceden kimlik doğrular.
python manage.py mcp_stdio --user=your-username
# Claude Desktop config for local stdio:
{
"mcpServers": {
"polydrobe-local": {
"command": "python",
"args": ["manage.py", "mcp_stdio", "--user=your-username"],
"cwd": "/path/to/polydrobe"
}
}
}
5. Deneyin
Bağlantı kurulduktan sonra yapay zekâ asistanınıza proje verileriniz hakkında doğal dilde sorular sorun.
# Example prompts for your AI assistant: "List all my projects" "Show me the assets in project 'cyber-skins'" "Create a new asset called 'Neon Jacket' in the 'outerwear' category" "Search for legendary variants with price above 20" "Set up categories: Headwear, Outerwear, Footwear, Accessories" "Tag all sword assets with 'melee' and 'weapon'" "Export the project data as JSON" "Give me a project overview with sample thumbnails"
Kullanılabilir MCP araçları
PolyDrobe'daki her okuma, yazma, arama ve dışa aktarma işlemi bir araç olarak sunulur. Yapay zekâ asistanı, kategorilere göre gruplanmış bu setin tamamını bağlanırken keşfeder; ayrıca yapılandırma gerekmez.
Projects: list_projects, get_project, create_project,
update_project, delete_project
Assets: list_assets, get_asset, create_asset,
update_asset, delete_asset
Variants: list_variants, create_variant,
update_variant, delete_variant
Bundles: list_bundles, get_bundle, create_bundle,
update_bundle, delete_bundle, list_bundle_items,
add_bundle_item, remove_bundle_item,
find_bundles_containing_variant
Collections: collections_list, collections_get,
collections_create, collections_update,
collections_delete, collections_add_member,
collections_remove_member, collections_duplicate
Classification: list_categories, create_category, update_category,
delete_category, list_tags, create_tag, delete_tag,
list_rarities, create_rarity, list_releases,
create_release, list_currencies, create_currency,
list_statuses, create_status
Tags: add_asset_tags, remove_asset_tags,
add_variant_tags, remove_variant_tags
Favorites: list_favorites, add_favorite,
remove_favorite, toggle_favorite
Team: list_members, update_member_role, remove_member
Search: search (full-text across assets & variants)
Activity: get_activity_log
Images: fetch_variant_thumbnail, fetch_variant_image,
fetch_variant_texture, set_variant_thumbnail
Bulk: bulk_create_variants, bulk_update_variants,
bulk_delete_variants
Data: export_project, import_project_data
Üretim için OAuth 2.1 (ileri düzey)
CI/CD pipeline'ları ve sunucudan sunucuya entegrasyonlarda kişisel jetonlar yerine OAuth 2.1 istemci kimlik bilgileri akışını kullanabilirsiniz. OAuth uygulaması kurulumu için destek ekibiyle iletişime geçin.
# Exchange client credentials for an access token: curl -X POST https://polydrobe.app/o/token/ \ -d "grant_type=client_credentials" \ -d "client_id=your-client-id" \ -d "client_secret=your-client-secret" \ -d "scope=read write" # For most use cases, personal access tokens from # Workspace Settings > API Tokens are simpler and sufficient.
Kim ne yapabilir
Herkesin neyi değiştirmesi gerektiğine göre çizilmiş üç rol. Görüntüleyiciler ücretsiz kalır.
Sahip
Proje ayarlarını, plan limitlerini ve ekip erişimini yönetir.
- Proje ayarları
- Faturalama
- Takım yönetimi
- Varlık oluştur veya düzenle
- İçe ve Dışa Aktarma
- Salt okunur gezinme
Editör
Varlık, varyant ve operasyonel verileri oluşturur/günceller.
- Proje ayarları
- Faturalama
- Takım yönetimi
- Varlık oluştur veya düzenle
- İçe ve Dışa Aktarma
- Salt okunur gezinme
Görüntüleyici
İnceleme, QA ve paydaş görünürlüğü için proje verisini görüntüler.
- Proje ayarları
- Faturalama
- Takım yönetimi
- Varlık oluştur veya düzenle
- İçe ve Dışa Aktarma
- Salt okunur gezinme
Sıkça sorulan sorular
PolyDrobe nedir?
PolyDrobe hangi tür varlıkları yönetir?
PolyDrobe 3D model önizlemeyi destekliyor mu?
PolyDrobe, oyun varlığı takibinde Google Sheets'e kıyasla ne sunar?
PolyDrobe'un Notion veya Airtable'dan farkı nedir?
PolyDrobe hangi oyun motorlarıyla uyumlu?
Yapay zekâ ajanları PolyDrobe ile etkileşime girebilir mi?
REST API ile MCP sunucusu arasındaki fark nedir?
API erişim jetonunu nasıl alırım?
PolyDrobe ekip iş birliğini destekliyor mu?
Her skin'i varlık mı yoksa varyant mı yapmalıyım?
İsimlendirmeyi nasıl tutarlı tutarım?
Proje verisini dış sistemlerle paylaşabilir miyim?
Free planına neler dahildir?
Görüntüleyici koltukları faturalandırmaya dahil mi?
PolyDrobe bir SaaS ürünü mü?
Mevcut varlık verilerimi PolyDrobe'a aktarabilir miyim?
Google Sheets içe aktarma şablonu hangi sütunları ister?
Google Sheets içe aktarmam neden 'E-tablo meta verileri yüklenemedi' diyor?
Google'ı her proje için ayrı ayrı bağlamam gerekiyor mu?
Yaygın sorunlar
En sık karşılaşılan sorunlar için hızlı çözümler.
Eksik izinler
Bir işlem görünmüyorsa rolünüzü kontrol edin ve bir Sahip'ten erişim güncellemesi isteyin.
İçe aktarma doğrulama hataları
Tekrar denemeden önce zorunlu alanları, kategori sluglarını ve enum değerlerini kontrol edin.
Medya yükleme sorunları
Dosya tipi, dosya boyutu ve depolama kullanımını plan limitlerine göre doğrulayın.
Google Sheets: 'E-tablo meta verileri yüklenemedi'
Dosya büyük olasılıkla yerel bir Google E-Tablosu değil, yüklenmiş bir .xlsx. Dosyayı açın, File > Save as Google Sheets seçeneğini kullanın, ardından senkronizasyon profilinizde Gözat'a tıklayıp dönüştürülmüş dosyayı seçin. Ayrıca bağlı Google hesabının e-tabloyu açabildiğini kontrol edin.
Google Sheets: Varlıklar veya varyantlar 'Tag not found' ya da 'Category not found' hatası veriyor
Başvurulan kayıtlar, herhangi bir şey onlara işaret etmeden önce var olmalıdır. İçe aktarma, çalışma sayfalarını sırayla gezer (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants); bu yüzden içe aktarılamayan bir kategori, kendi varlıklarını da beraberinde düşürür. Test çalıştırması önizlemesini baştan okuyun ve önce en erken kayıt türünü düzeltin.
Google Sheets: Varyant fiyatı 'invalid price' hatası veriyor
İçe aktarma, ondalık ayırıcı olarak hem noktayı (9.99) hem de virgülü (9,99) kabul eder. Hata sürerse fiyat hücresinde başıboş karakterler, para birimi simgeleri veya boşluklar olup olmadığına bakın.