Documentatie

Docs

Technische referentie voor Deckbase-integraties, API's en ontwikkelaarsgidsen.

Referentie

Snelle links

Snel starten

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}'

Vervang YOUR_ACCESS_TOKEN door een OAuth-token van je Connect-pagina. Voor installatie-instructies, zie de MCP-installatiehandleiding.

API-overzicht

Deckbase biedt twee integratiepaden: de MCP-server voor AI-ondersteund beheer van decks en kaarten, en directe REST API-endpoints voor programmatische toegang.

  • Maak, werk bij en verwijder decks en kaarten in batches
  • Genereer AI-audio en afbeeldingen voor kaarten via ElevenLabs en afbeeldingsmodellen
  • Exporteer volledige deckgegevens, inclusief blok-snapshots en metadata
  • Bouw aangepaste sjablonen met flexibele blokindelingen
  • Ontvang webhook-events voor wijzigingen in decks en kaarten

Begin hier

Beste praktijken

Behandel het aanmaken van kaarten als een operationele pipeline

Houd requestlogs bij, valideer verplichte sjabloonvelden vóór schrijfoperaties en controleer een steekproef van gegenereerde kaarten voordat je de batchgrootte opschaalt.

Definieer één canonieke sjabloonstrategie

Definieer voor teams één canonieke sjabloonstrategie en één retry-beleid. Dit voorkomt dubbele promptdrift en maakt incidentrespons veel sneller wanneer mapperregels veranderen.

Volg de aanbevolen leesvolgorde

Eerst de setup-pagina, daarna de MCP Server-referentie, en vervolgens de controles voor productie-uitrol. Dit pad minimaliseert authenticatiefouten en schema-mismatches tijdens het aanmaken van kaarten.

Documenteer regels in je repo

Als je teamworkflows implementeert, documenteer je sjabloonregels en batch-acceptatiedrempels dan direct in je repo, zodat toekomstige updates consistent blijven.

Voer een wekelijkse operationele review uit

Controleer recente schrijffouten, sjabloondrift en het duplicaattarief van prompts voordat je het automatiseringsvolume opschaalt.

Versiebeheer je integratiechecklist

Houd je integratiechecklist onder versiebeheer, zodat het onboarden van nieuwe bijdragers geen reverse engineering van eerdere MCP-setupbeslissingen vereist.

Neem een rollback-runbook op

Neem waar mogelijk een kort runbook op voor rollback en het opnieuw verwerken van mislukte batches, zodat productie-updates veilig blijven, zelfs wanneer sjablonen evolueren.

FAQ

Voor gidsen en artikelen, zie Bronnen