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
| Modul | Pfad |
|---|---|
| OAuth / Tokens | lib/canva/connection-service.ts, oauth-pkce.ts, token-crypto.ts |
| API-Client | lib/canva/client.ts |
| Designs | lib/canva/designs.ts, parse-design-url.ts |
| Export | lib/canva/export.ts |
| Import-Job | lib/canva/import-service.ts |
Dashboard-API
| Methode | Route |
|---|---|
| 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_designscockpit_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: /en/developer-guide/canva-connect-integration