Tools Canva
Les 12 opérations Canva que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- 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.
- Importer un asset depuis une URLPOSTLance l'import d'un fichier depuis une URL publique vers les Uploads de l'utilisateur et renvoie le job avec son id. Appelez Get URL asset upload jusqu'à ce que status vale success, qui apporte l'asset et son id. Les vidéos peuvent aller jusqu'à 100 Mo.
- Consulter un import d'asset par URLGETRenvoie un job d'import : status in_progress, success ou failed et, avec success, l'asset avec son id. Rappelez-le, avec des attentes croissantes, tant que status vaut in_progress.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
