API de Figma: archivos, comentarios y componentes con agentes de IA
La API REST de Figma permite leer la estructura de los archivos, exportar imágenes de frames, gestionar comentarios y consultar componentes y estilos publicados. La usan equipos de producto, diseño e ingeniería para automatizar y documentar. El acceso es por un token personal u OAuth.
Qué ofrece la API de Figma
Archivos y nodos
Leer el árbol de páginas, frames y capas de un archivo.
Exportar imágenes
Generar PNG, SVG o PDF de frames y componentes.
Comentarios
Leer, crear y responder comentarios en los archivos.
Componentes y estilos
Consultar las bibliotecas publicadas del equipo.
Proyectos y versiones
Listar proyectos y el historial de versiones de un archivo.
Webhooks
Recibir eventos como la actualización de un archivo y nuevos comentarios.
Cómo acceder a la API de Figma
- Con las credenciales de tu empresaToken de acceso personal generado en la configuración de la cuenta, u OAuth 2.0 con una app registrada en Figma, con permisos de lectura y escritura.
- El token personal hereda el acceso del usuario; prefiere un usuario de servicio.
- La exportación de imágenes grandes cuenta en los límites de solicitudes.
- Los archivos pueden tener información confidencial de producto.
Documentación oficial: www.figma.com/developers/api
Qué hace un agente de iTeam con la API de Figma
Recopilación de feedback
El agente reúne los comentarios de un archivo, los agrupa por tema y envía al diseñador una lista de lo que falta resolver.
Documentación de entrega
Cuando el archivo se marca como listo, el agente exporta las pantallas y crea la tarea de desarrollo con las imágenes.
Auditoría de componentes
El agente señala las pantallas con elementos que no son de la biblioteca de componentes.
Aviso de cambios
El agente avisa en Slack cuando cambia un archivo crítico, con el enlace a la versión.
De la credencial al agente trabajando, con aprobación
Crear el token o la app
Genera un token personal de un usuario de servicio o registra una app OAuth con permisos mínimos.
Bóveda y archivos permitidos
Guárdalo en la bóveda de iTeam y limita el agente a los proyectos necesarios.
Prueba con aprobación
Al principio, los comentarios que publica el agente pasan por aprobación, con auditoría.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Gestión de inventario
Nina vigila cada referencia, Darwin calcula cuánto reponer y la orden de compra sale solo cuando una persona la aprueba.
Compras y cotizaciones
Darwin pide cotizaciones y las compara en una tabla, Henry revisa las condiciones y la orden de compra sale con la aprobación registrada.
Logística y entregas
Nina arma las rutas y sigue a cada conductor por WhatsApp; Jaca avisa al cliente del estado de su pedido antes de que llame.
Preguntas sobre la API de Figma
¿La API de Figma es gratuita?
La API REST está disponible para las cuentas de Figma, incluidas las gratuitas, con recursos y límites que pueden variar según el plan. Consulta las reglas vigentes.
¿Necesito programar para usar la API de Figma con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación de la API y aprende los endpoints, y el equipo de implantación configura contigo credenciales, permisos y pruebas.
¿La API de Figma permite editar el diseño?
La API REST está orientada sobre todo a la lectura, la exportación, los comentarios y las bibliotecas. Editar capas y el dibujo en sí es trabajo de los plugins dentro de Figma, no de la API REST.
