A ajuda explica como as coisas funcionam; a documentação da API lista cada endpoint com todos os parâmetros e exemplos de resposta. Ela está em flowdata.one/pt/docs, pública e sem necessidade de login, e também em alemão e inglês.
Como chegar lá
- No dashboard, à esquerda, em Mais, clique em Documentação da API
- Em cada página de área, no canto superior direito, clique em Documentação para ir direto àquela área
O que há nas páginas
A página inicial traz a URL base https://api.flowdata.one/v1, as seis áreas, os preços de tabela e todos os arquivos OpenAPI. Os preços válidos para sua equipe aparecem no dashboard, em Cobrança.
| Tema | Página |
|---|---|
| Autenticação e códigos de erro | /pt/docs/authentication |
| IP Geolocation | /pt/docs/geolocation |
| Client Info | /pt/docs/client-info |
| Maps | /pt/docs/maps |
| Email Verifier | /pt/docs/email-verification |
| YouTube | /pt/docs/youtube |
| Processamento de mídia | /pt/docs/media |
A página de uma área lista cada endpoint com os parâmetros de caminho, de consulta e do corpo, um exemplo para copiar e um exemplo de resposta.
Arquivos OpenAPI
Para ferramentas e clientes gerados, a mesma descrição está disponível em formato OpenAPI, legível por máquina. Você baixa os arquivos sem chave:
| Escopo | Endereço |
|---|---|
| API completa | https://flowdata.one/pt/docs/openapi.json |
| IP Geolocation | https://flowdata.one/pt/docs/geolocation/openapi.json |
| Client Info | https://flowdata.one/pt/docs/client-info/openapi.json |
| Maps | https://flowdata.one/pt/docs/maps/openapi.json |
| Email Verifier | https://flowdata.one/pt/docs/email-verification/openapi.json |
| YouTube | https://flowdata.one/pt/docs/youtube/openapi.json |
| Processamento de mídia | https://flowdata.one/pt/docs/media/openapi.json |
As versões em alemão e inglês ficam em /docs/... e /en/docs/..., por exemplo https://flowdata.one/en/docs/openapi.json.
Para usar um arquivo:
- Carregue o arquivo na sua ferramenta, como um cliente de API ou um gerador de código.
- Cadastre ali sua chave FlowData como token Bearer. Veja como obtê-la em Criar uma chave de API do FlowData.
- Envie uma primeira requisição a um endpoint gratuito, como
GET /client-info.
Bom saber
- Para testar requisições sem integrar nada, use o Playground.
- Se você ainda usa os endereços antigos em
creativeskyline.de/api/..., veja Migrar para api.flowdata.one. - Exemplos de código prontos estão em Chamar o FlowData em PHP, JavaScript e Python.