Productivité
Figma dans votre produit et vos agents IA, via une API
Le toolkit Figma couvre les métadonnées et le contenu des fichiers, le rendu de nœuds, l'historique des versions, les commentaires et les composants et styles publiés dans les bibliothèques. Votre client connecte Figma une fois via OAuth, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke et renouvelle les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/figma_create_comment/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"file_key": "<file_key>",
"message": "<message>"
}
}Fonctionnement
Du client connecté au premier appel à Figma.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Figma. 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 Figma.
Revue de design dans votre app
Listez les commentaires d'un fichier et publiez des réponses ou de nouveaux commentaires en tant qu'utilisateur connecté, pour garder les retours de revue dans votre flux.
Exporter des frames en images
Lisez un frame avec Obtenir des nœuds du fichier et appelez Générer des images pour obtenir des URL d'image temporaires pour le handoff, la documentation ou les aperçus.
Un agent lit le design system
Un agent IA liste les composants et styles publiés d'une équipe, puis lit leurs nœuds pour répondre aux questions sur le design system.
Tools
12 tools Figma
- Obtenir les métadonnées du fichierGETRenvoie les métadonnées d'un fichier sans son contenu : nom, dossier, type d'éditeur (Figma Design, FigJam, Slides et autres), créateur, dernier auteur de modification et date, miniature, rôle de l'utilisateur et accès par lien. Bien moins coûteux qu'Obtenir le fichier dans les limites de débit de Figma, à utiliser en premier quand la question porte sur le fichier et non sur ses calques.
- Obtenir le fichierGETRenvoie l'arbre du document d'un fichier : pages, frames et calques avec leurs propriétés et ids, ainsi que les composants et styles utilisés par le fichier. L'arbre d'un gros fichier est énorme : passez depth 1 pour les pages seules, ou 2 pour les frames de premier niveau de chaque page, puis lisez un frame avec Obtenir des nœuds du fichier. Figma place cet appel dans son niveau de limite de débit le plus bas : les fichiers d'un plan Starter et les utilisateurs avec un siège View ou Collab n'ont que 20 appels par mois.
- Obtenir des nœuds du fichierGETRenvoie les frames ou calques indiqués d'un fichier, chacun avec tout son sous-arbre, dans nodes, plus le nom, la version et la dernière modification du fichier. Un nœud inexistant revient à null. C'est la manière légère de lire un frame d'un gros fichier. Figma place cet appel dans son niveau de limite de débit le plus bas : les fichiers d'un plan Starter et les utilisateurs avec un siège View ou Collab n'ont que 20 appels par mois.
- Générer des imagesGETGénère des images à partir de frames ou calques d'un fichier et renvoie, dans images, une correspondance entre chaque id de nœud et une URL temporaire de l'image, valable 30 jours. Une valeur null signifie que ce nœud n'a pas pu être rendu. Les images de plus de 32 mégapixels sont réduites. Figma place cet appel dans son niveau de limite de débit le plus bas : les fichiers d'un plan Starter et les utilisateurs avec un siège View ou Collab n'ont que 20 appels par mois.
- Lister les versions du fichierGETListe l'historique des versions d'un fichier, de la plus récente à la plus ancienne : id, date de création, auteur, et le libellé et la description des versions nommées. Pour lire des versions plus anciennes, passez comme before la valeur before du lien pagination.next_page ; l'historique se termine quand next_page est absent.
- Lister les commentairesGETListe tous les commentaires d'un fichier, réponses comprises. Chaque commentaire a id, message, auteur, created_at, resolved_at quand il a été résolu, sa position dans client_meta et les réactions. Une réponse porte l'id de son commentaire racine dans parent_id.
- Créer un commentairePOSTPublie un commentaire sur un fichier en tant qu'utilisateur connecté et le renvoie, ou une réponse quand comment_id est envoyé. Sans client_meta, le commentaire n'est pas épinglé à un endroit du canvas. Un commentaire publié ne peut pas être modifié, seulement supprimé avec Supprimer un commentaire.
- Supprimer un commentaireDELETESupprime un commentaire d'un fichier. Figma ne permet qu'à l'auteur de supprimer un commentaire, donc cela fonctionne sur les commentaires faits par l'utilisateur connecté.
- Lister les composants du fichierGETListe les composants publiés depuis un fichier de bibliothèque : key, nom, description, node_id, miniature, dates, auteur, et le frame et la page qui contiennent chacun. Les composants jamais publiés n'apparaissent pas.
- Lister les composants de l'équipeGETListe les composants publiés dans les bibliothèques d'une équipe, avec le file_key et le node_id de chacun, que Obtenir des nœuds du fichier et Générer des images acceptent. La réponse contient meta.cursor : passez sa valeur after comme after pour lire la page suivante ; la liste se termine quand after est absent.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/figma, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Figma
Dois-je intégrer l'API Figma moi-même ?
Non. Connect fournit 12 tools Figma 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 Figma ?
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.
