Gerando e usando seu token de API

A autenticação da API do Fácil123 é feita por meio de token do tipo Bearer, enviado no cabeçalho HTTP Authorization. Para entender como o token se comporta no sistema, veja Características do token de API.

Como obter seu token de API

1. Acesse sua conta no Fácil123.
2. Vá até Configurações > Tokens de API.
3. Clique em "Incluir".
4. Preencha as informações necessárias.
5. Copie o token gerado e utilize ele para fazer suas requisições.

Como utilizar o token

Todas as requisições à API devem incluir o cabeçalho Authorization, no seguinte formato:

Authorization: Bearer seu_token_de_api

Exemplo de uso com cURL

curl -X POST https://app.facil123.com.br/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -d '{"query": "{ getCurrentUser { name email } }"}'

Exemplo de resposta

{
  "data": {
    "getCurrentUser": {
      "name": "Seu Nome",
      "email": "voce@exemplo.com"
    }
  }
}

Campos não preenchidos (como um e-mail ausente em tokens de API) são retornados como null.

Importante: qualquer pessoa com acesso ao seu token poderá consultar e modificar dados através da API. Nunca compartilhe seu token publicamente, nem o inclua diretamente em repositórios de código versionado (como o GitHub). Use variáveis de ambiente sempre que possível.

Revogação de tokens

Em caso de vazamento, suspeita de uso indevido ou por motivos de segurança, você pode revogar imediatamente qualquer token ativo diretamente no painel de controle do Fácil123. Essa operação invalida o token de forma instantânea, bloqueando qualquer uso futuro daquele identificador.

Recomenda-se revogar tokens antigos ou não utilizados e manter uma rotação periódica de tokens em ambientes sensíveis.

Validade dos tokens

Os tokens da API do Fácil123 não expiram automaticamente, mas sua validade pode ser gerenciada manualmente. Para manter boas práticas de segurança, sugerimos que você crie novos tokens periodicamente e revogue os anteriores.