API

Selecionamos os principais materiais sobre a API do Fácil123.

Visão geral da API

Introdução à API GraphQL do Fácil123, URL base, formato e tipos de token.

Leia o artigo

Usando a API com um agente de IA

As regras que um agente de IA precisa seguir para trabalhar bem com a API do Fácil123, reunidas para você colar nas instruções dele.

Leia o artigo

Gerando e usando seu token de API

Como criar, usar, revogar e rotacionar tokens Bearer da API do Fácil123.

Leia o artigo

Características do token de API

Como o token se comporta — monolicenciado, sem sessão, permissões e respostas a requests não autenticados.

Leia o artigo

Tokens pessoais

Crie tokens que autenticam na API como você mesmo — ideais para emprestar sua identidade a um agente de IA.

Leia o artigo

Explorando a API por introspecção

Descubra queries, mutations, tipos e enums do schema GraphQL diretamente pelo endpoint.

Leia o artigo

Usando templates de novos registros na API

As queries getNewXXX devolvem objetos pré-preenchidos com os defaults do servidor para você usar como base de criação.

Leia o artigo

Enviando imagens pela API com direct upload

Fluxo de três passos para enviar imagens via URL pré-assinada e referenciá-las nas mutations via signed_id.

Leia o artigo

Entendendo os erros da API

Os códigos de erro que a API devolve, o que cada um significa e o que fazer em cada caso.

Leia o artigo

Exemplos de uso da API

Cenários completos costurando templates, introspecção, cálculo de tributos e mutations.

Leia o artigo

Executando relatórios personalizados pela API

Dispare a geração de um relatório personalizado e busque o resultado por consultas repetidas, com instruções prontas para colar no seu agente de IA.

Leia o artigo

Limite de requisições da API

Quantas requisições você pode fazer por minuto e por segundo, como a cota é contada e o que fazer quando a API responde 429.

Leia o artigo

Webhooks

Como o Fácil123 envia webhooks para outros sistemas através das automações.

Leia o artigo