Tools do Figma
As 12 operações do Figma que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Obter metadados do arquivoGETRetorna os metadados de um arquivo sem o conteúdo: nome, pasta, tipo de editor (Figma Design, FigJam, Slides e outros), criador, quem alterou por último e quando, miniatura, o papel do usuário e o acesso por link. Bem mais barato que Obter arquivo nos limites de taxa do Figma, então use primeiro quando a pergunta é sobre o arquivo e não sobre suas camadas.
- Obter arquivoGETRetorna a árvore do documento de um arquivo: páginas, frames e camadas com suas propriedades e ids, além dos componentes e estilos que o arquivo usa. A árvore de um arquivo grande é enorme: passe depth 1 para só as páginas, ou 2 para os frames de nível superior de cada página, e depois leia um frame com Obter nós do arquivo. O Figma coloca esta chamada no menor nível de limite de taxa: arquivos em um plano Starter e usuários com assento View ou Collab têm só até 20 chamadas por mês.
- Obter nós do arquivoGETRetorna os frames ou camadas indicados de um arquivo, cada um com toda a sua subárvore, em nodes, além do nome, versão e última alteração do arquivo. Um nó que não existe volta como null. É a forma leve de ler um frame de um arquivo grande. O Figma coloca esta chamada no menor nível de limite de taxa: arquivos em um plano Starter e usuários com assento View ou Collab têm só até 20 chamadas por mês.
- Renderizar imagensGETRenderiza frames ou camadas de um arquivo como imagens e retorna, em images, um mapa de cada id de nó para uma URL temporária da imagem, válida por 30 dias. Valor null significa que aquele nó não pôde ser renderizado. Imagens acima de 32 megapixels são reduzidas. O Figma coloca esta chamada no menor nível de limite de taxa: arquivos em um plano Starter e usuários com assento View ou Collab têm só até 20 chamadas por mês.
- Listar versões do arquivoGETLista o histórico de versões de um arquivo, da mais recente à mais antiga: id, data de criação, autor, e o rótulo e a descrição das versões nomeadas. Para ler versões mais antigas, passe como before o valor before do link pagination.next_page; o histórico termina quando next_page não existe.
- Listar comentáriosGETLista todos os comentários de um arquivo, respostas incluídas. Cada comentário tem id, message, autor, created_at, resolved_at quando foi resolvido, sua posição em client_meta e as reações. Uma resposta traz o id do comentário raiz em parent_id.
- Criar comentárioPOSTPublica um comentário em um arquivo como o usuário conectado e o retorna, ou uma resposta quando comment_id é enviado. Sem client_meta o comentário não fica fixado em um ponto do canvas. Um comentário publicado não pode ser editado, só excluído com Excluir comentário.
- Excluir comentárioDELETEExclui um comentário de um arquivo. O Figma só permite que o autor exclua um comentário, então funciona nos comentários feitos pelo usuário conectado.
- Listar componentes do arquivoGETLista os componentes publicados de um arquivo de biblioteca: key, nome, descrição, node_id, miniatura, datas, autor e o frame e a página que contêm cada um. Componentes nunca publicados não aparecem.
- Listar componentes do timeGETLista os componentes publicados nas bibliotecas de um time, com o file_key e o node_id de cada um, que Obter nós do arquivo e Renderizar imagens aceitam. A resposta traz meta.cursor: passe seu valor after como after para ler a próxima página; a lista termina quando after não existe.
- Listar estilos do arquivoGETLista os estilos publicados de um arquivo de biblioteca: cores, texto, efeitos e grades, com key, nome, style_type, descrição e node_id. Os valores de um estilo estão no nó dele: leia com Obter nós do arquivo.
- Listar estilos do timeGETLista os estilos publicados nas bibliotecas de um time, com o file_key e o node_id de cada um; os valores estão no nó, lidos com Obter nós do arquivo. A resposta traz meta.cursor: passe seu valor after como after para ler a próxima página; a lista termina quando after não existe.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
