Developer API v1 & PAT
Sayfa taslaklarını okuyup yazın; scope ve süre panelden yönetilir, iptal panelden.
Geliştiriciler
Developer API, webhook'lar ve @tecof/mcp ile Tecof'u kendi araçlarınıza bağlayın
PAT ile Developer API v1'e erişin, olayları imzalı webhook'larla alın, tema kodunu Cloud IDE'de düzenleyin ve Claude Code, Codex veya Gemini'den sayfa taslağı yazın.
Geliştirici yüzeyi
Standart akışı bozmadan genişletin; tema kodu sizde, yayın her zaman panelden.
API v1
PAT ile /api/v1/* uçları
PAT
pages:read · pages:write scope; süreli, iptal edilebilir
HMAC
X-Webhook-Event başlığı ve imza doğrulama
@tecof/mcp
Claude Code · Codex · Gemini CLI
Yetenekler
Kod gerektiğinde tam kontrol
Altı geliştirici yüzeyi; hepsi aynı hesap ve paket kapsamında çalışır.
Webhook'lar
Sipariş, müşteri ve içerik olayları kendi sisteminize; HMAC imzasıyla doğrulanır.
Cloud IDE kod erişimi
Tema kodunu tarayıcıdan düzenleyin; Studio uyumlu section ve elementler ekleyin.
@tecof/mcp
Claude Code, Codex veya Gemini CLI'dan sayfa taslağı üretin; tema kataloğu diskten okunur.
Headless kullanım
İçerik ve ürün verisini API'den alıp kendi ön yüzünüzde gösterin.
Tema kodu & bileşenler
Section = yerleşim + slot, element = içerik. Kendi bileşeninizi kaydedin, Studio'da kullanın.
Başlangıç
İki dosya: bir istek, bir .mcp.json
PAT'ı panelden alın (Ayarlar → Geliştirici / API Anahtarları), isteği Bearer başlığıyla gönderin; MCP için .mcp.json yeterli.
Kimlik doğrulama
Authorization: Bearer tcf_… başlığı; anahtar sunucuda hash'lenmiş saklanır.
Scope'lar
pages:read ve pages:write; her istekte ekip üyeliği yeniden kontrol edilir.
Süre & iptal
30, 90, 180 veya 365 gün; panelden anında iptal.
Mağaza bağlamı
Anahtar kullanıcı ve mağazaya bağlıdır; ayrıca mağaza kimliği göndermeniz gerekmez.
Developer API v1 · .mcp.json
# GET /api/v1/pages — sayfa taslaklarını listeleyin (PAT, scope: pages:read)curl -s "$TECOF_API_URL/api/v1/pages?themeId=$TECOF_THEME_ID" \ -H "Authorization: Bearer $TECOF_API_TOKEN" # .mcp.json — Claude Code / Codex / Gemini CLI'dan sayfa taslağı{ "mcpServers": { "tecof": { "type": "stdio", "command": "npx", "args": ["-y", "@tecof/mcp@latest"] } }}MCP ile sayfa taslağı
PAT alın, MCP'yi kurun, ilk taslağı yazın
Üç adım; taslak Studio'da görünür, yayın kararı panelde kalır.
01
Panelden PAT oluşturun
Ayarlar → Geliştirici / API Anahtarları; pages:read ve pages:write scope'larını ve süreyi seçin.
02
.mcp.json ile @tecof/mcp'yi ekleyin
Tema reponuza .mcp.json koyun; Claude Code, Codex veya Gemini CLI sunucuyu otomatik başlatır.
03
Sayfa taslağı yazın
Ajan tema kataloğundaki section ve elementlerle taslağı oluşturur; Studio'da düzenleyip yayınlarsınız.
Modüller
Geliştirici modülleri hangi pakette?
API erişimi, webhook'lar ve Cloud IDE; her kartta modülün açıldığı en düşük paket yazar.
Modül kataloğu yükleniyor
Sık sorulan sorular
Geliştiriciler için sık sorulanlar
Cevabını bulamadığınız soru için iletişim formunu kullanın.
Geliştirici erişimi
İlk siteyi kurun, geliştirici araçlarını paketinize göre açın
Kayıt olun, panelden PAT üretin ve @tecof/mcp ile ilk taslağı yazın. Geliştirici modüllerinin paket kapsamı fiyatlandırma sayfasında listelenir.
Developer API v1 · Webhook'lar · Cloud IDE · @tecof/mcp