Marketing
Canva dans votre produit et vos agents IA, via une API
Le toolkit Canva couvre les designs (lister, lire, créer), les exports en PDF, JPG, PNG, PPTX, GIF ou MP4, le contenu des dossiers et les assets, y compris l'import depuis une URL publique. Le client connecte Canva une fois par OAuth sur votre propre app, et Connect garde les tokens à jour et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/canva_create_design/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"type": "type_and_asset"
}
}Fonctionnement
Du client connecté au premier appel à Canva.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Canva. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Canva.
Exporter des designs en fichiers
Lancez l'export d'un design en PDF ou PNG, interrogez Get design export jusqu'à status success et livrez les fichiers à l'utilisateur dans votre produit.
Ouvrir le bon design
Listez les designs de l'utilisateur et affichez titres, miniatures et urls d'édition, ou créez un nouveau design à partir d'un design_type ou d'un asset_id existant.
Alimenter la bibliothèque de marque
Importez logos et images depuis des URL publiques dans les Uploads de l'utilisateur, puis renommez-les ou re-étiquetez-les avec Update asset, depuis votre produit ou un agent IA.
Tools
12 tools Canva
- Lister les designsGETListe les designs des projets de l'utilisateur et ceux partagés avec lui, avec id, title, thumbnail, page_count et les urls d'édition et de consultation. Quand la réponse contient continuation, passez-le en continuation pour lire la page suivante.
- Consulter un designGETRenvoie un design avec son titre, son propriétaire, sa miniature, page_count et les urls d'édition et de consultation. Ces urls sont temporaires et ne s'ouvrent que pour l'utilisateur connecté.
- Créer un designPOSTCrée un design et le renvoie avec son id et les urls d'édition et de consultation. Envoyez design_type, asset_id ou les deux. Un design vierge que personne ne modifie sous 7 jours est supprimé définitivement, sans passer par la corbeille.
- Lister les formats d'exportGETListe les formats vers lesquels un design peut être exporté, selon son type et ses pages. Un format avec page_numbers ne vaut que pour ces pages.
- Créer un export de designPOSTLance l'export d'un design en PDF, JPG, PNG, PPTX ou GIF et renvoie le job avec son id. Appelez Get design export jusqu'à ce que status vale success : les urls des fichiers sont valables 24 heures. Chaque utilisateur peut exporter 75 fois toutes les 5 minutes et 500 fois par jour.
- Créer un export vidéo de designPOSTLance l'export d'un design en vidéo MP4 et renvoie le job avec son id. Appelez Get design export jusqu'à ce que status vale success : les urls des fichiers sont valables 24 heures. Chaque utilisateur peut exporter 75 fois toutes les 5 minutes et 500 fois par jour.
- Consulter un export de designGETRenvoie un job d'export : status in_progress, success ou failed et, avec success, les urls des fichiers, une par page selon le format, valables 24 heures. Rappelez-le, avec des attentes croissantes, tant que status vaut in_progress.
- Lister le contenu d'un dossierGETListe les dossiers, designs et images d'un dossier, chacun avec son type, l'objet dossier, design ou image et son id. Les vidéos ne sont pas listées. Quand la réponse contient continuation, passez-le en continuation pour lire la page suivante.
- Consulter un assetGETRenvoie un asset avec son nom, ses tags, sa miniature, son propriétaire et ses dates.
- Mettre à jour un assetPATCHMet à jour le nom ou les tags d'un asset et le renvoie. Les tags envoyés remplacent toutes les tags actuelles.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/canva, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Canva
Dois-je intégrer l'API Canva moi-même ?
Non. Connect fournit 12 tools Canva décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Canva ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
