Dokumentasi

Dokumentasi

Referensi teknis untuk integrasi, API, dan panduan pengembang Deckbase.

Referensi

Tautan cepat

Mulai cepat

curl -X POST https://www.deckbase.co/api/mcp \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Ganti YOUR_ACCESS_TOKEN dengan token OAuth dari halaman Connect. Untuk petunjuk pengaturan, lihat panduan pengaturan MCP.

Ikhtisar API

Deckbase menyediakan dua jalur integrasi: server MCP untuk pengelolaan deck dan kartu berbantuan AI, dan endpoint REST API langsung untuk akses terprogram.

  • Buat, perbarui, dan hapus deck serta kartu secara massal
  • Hasilkan audio dan gambar AI untuk kartu melalui ElevenLabs dan model gambar
  • Ekspor data deck lengkap termasuk snapshot blok dan metadata
  • Bangun template khusus dengan tata letak blok yang fleksibel
  • Terima event webhook untuk perubahan deck dan kartu

Mulai dari sini

Praktik terbaik

Perlakukan pembuatan kartu sebagai pipeline operasional

Simpan log permintaan, validasi kolom template wajib sebelum menulis, dan periksa sampel kartu yang dihasilkan sebelum meningkatkan ukuran batch.

Tetapkan satu strategi template kanonis

Untuk tim, tetapkan satu strategi template kanonis dan satu kebijakan percobaan ulang. Hal ini menghindari penyimpangan prompt duplikat dan mempercepat respons insiden saat aturan pemetaan berubah.

Ikuti urutan baca yang direkomendasikan

Halaman pengaturan dahulu, referensi Server MCP kedua, lalu pemeriksaan peluncuran produksi. Jalur ini meminimalkan kesalahan autentikasi dan ketidakcocokan skema saat pembuatan kartu.

Dokumentasikan aturan di repositori Anda

Jika Anda menerapkan alur kerja tim, dokumentasikan aturan template dan gerbang penerimaan batch langsung di repositori Anda agar pembaruan berikutnya tetap konsisten.

Lakukan tinjauan operasional mingguan

Periksa kegagalan tulis terbaru, penyimpangan template, dan tingkat prompt duplikat sebelum meningkatkan volume otomatisasi.

Berikan versi pada daftar periksa integrasi Anda

Berikan versi pada daftar periksa integrasi Anda agar orientasi kontributor baru tidak memerlukan rekayasa balik keputusan pengaturan MCP sebelumnya.

Sertakan runbook rollback

Bila memungkinkan, sertakan runbook singkat untuk rollback dan pemrosesan ulang batch yang gagal agar pembaruan produksi tetap aman meskipun template berkembang.

Tanya jawab

Untuk panduan dan artikel, lihat Sumber daya