Zum Hauptinhalt springen

Canva Connect Integration

Architektur​

  • Canva-Aufrufe nur serverseitig (apps/dashboard/src/lib/canva/*)
  • Ein Plattform-Account im MVP (canva_connections.scope = platform)
  • Export-URLs von Canva sind kurzlebig → sofortiger Copy nach BunnyCDN
  • Freigabe/Publishing unverändert über Social Cockpit / Outstand

Module​

ModulPfad
OAuth / Tokenslib/canva/connection-service.ts, oauth-pkce.ts, token-crypto.ts
API-Clientlib/canva/client.ts
Designslib/canva/designs.ts, parse-design-url.ts
Exportlib/canva/export.ts
Import-Joblib/canva/import-service.ts

Dashboard-API​

MethodeRoute
GET/api/integrations/canva/connect
GET/api/integrations/canva/callback
GET/api/integrations/canva/status
PATCH/api/integrations/canva/connection — { defaultFolderId }
DELETE/api/integrations/canva/connection
GET/api/integrations/canva/folders?parentId=root — Unterordner (Admin)
GET/api/social/canva/designs — nutzt default_folder_id, Override ?folderId=all
GET/api/social/canva/designs/resolve?url=
GET/api/social/canva/designs/{designId}/pages
POST/api/social/drafts/{draftId}/canva-import — Body { designId, pages, format, mode } oder { reload: true }
GET/api/social/drafts/{draftId}/canva-source — gespeicherte Quelle + designChanged
GET/api/social/canva/import-jobs/{jobId} — bei done: mediaUrls

MCP​

  • cockpit_canva_search_designs
  • cockpit_social_import_from_canva

Datenmodell​

Siehe db_structure.md — Tabellen canva_connections, social_draft_canva_sources, canva_import_jobs.

Migration: packages/database/migrations/20260924103000_add_canva_connect_SAFE.sql

Rollen​

  • Import: EDITORIAL_AND_TECH_ROLES
  • OAuth connect/revoke: SUPER_ADMIN / ADMIN

Spec​

Ausgangsspec: Desktop „Spec Canva-Import im Social Cockpit.md" (Sep 2026).

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/canva-connect-integration