ACESSO
Chaves e limites
Como autenticar, quanto cada plano consulta e o que fazer quando uma chamada é recusada.
Autentique com a chave
Envie a chave no cabeçalho X-API-Key em todas as chamadas. Nunca coloque a chave na URL, em capturas de tela ou em código que roda no navegador.
curl -H "X-API-Key: SUA_CHAVE" \
"https://api.fintay.com.br/v1/series/sources" Troque
SUA_CHAVE pela sua chave. Crie uma conta grátis para gerar a sua. As rotas de conta, como criar chaves e ver o faturamento, usam a sessão do painel e não aceitam chave de API.
Limites por plano
Cada plano tem um limite por minuto e uma cota mensal de consultas:
| Plano | Por minuto | Por mês |
|---|---|---|
| Free | 60 | 5.000 |
| Individual | 200 | 20.000 |
| Pro | 600 | 75.000 |
| Empresas | sob consulta | sob consulta |
Acompanhe o consumo em Conta e API → Uso da API ou pela própria API:
curl -H "X-API-Key: SUA_CHAVE" \
"https://api.fintay.com.br/v1/auth/usage/api-key" Troque
SUA_CHAVE pela sua chave. Crie uma conta grátis para gerar a sua. Nota
As consultas feitas pelo ChatGPT ou pelo Claude conectados à sua conta entram na mesma cota mensal.
Quando a chamada é recusada
| Código | O que significa | O que fazer |
|---|---|---|
| 401 | Chave ausente, inválida ou revogada | Confira o cabeçalho X-API-Key e se a chave está ativa |
| 403 | Conta sem confirmação ou sem acesso ao recurso | Confirme o e-mail ou verifique o plano |
| 404 | Série ou identificador não encontrado | Busque o código certo no catálogo |
| 429 | Limite do minuto ou cota do mês atingidos | Espere e reduza a frequência; leia a mensagem do erro |
Guarde o código HTTP e o meta.request_id ao abrir um chamado: com eles o suporte encontra a sua chamada.
Proteja e revogue chaves
- Crie uma chave por integração, com um nome que identifique onde ela é usada.
- Se uma chave vazar, revogue em API Keys. As chamadas com ela param na hora.
- Revogar uma chave não afeta as outras.