O FlowData é composto por várias APIs de dados que você chama com a mesma chave FlowData em https://api.flowdata.one/v1. Este artigo explica rapidamente para que serve cada área e mostra uma requisição mínima de exemplo. Todos os parâmetros e exemplos de resposta estão na documentação da API.
Em todos os exemplos, substitua fd_SUA_CHAVE pela sua própria chave. Veja como obtê-la em Criar uma chave de API do FlowData.
IP Geolocation
Retorna país, região, cidade, coordenadas, fuso horário e provedor de um endereço IP ou domínio. Usos típicos: situar visitantes em uma região aproximada ou identificar pedidos suspeitos.
curl "https://api.flowdata.one/v1/geolocation/8.8.8.8?lang=de" \
-H "Authorization: Bearer fd_SUA_CHAVE"
Sem um endereço no caminho (/v1/geolocation), você recebe os dados do endereço IP de onde vem a requisição. Para consultar vários endereços de uma vez, use POST /v1/geolocation/batch. O corpo é um array JSON com no máximo 100 entradas:
curl -X POST "https://api.flowdata.one/v1/geolocation/batch" \
-H "Authorization: Bearer fd_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '["8.8.8.8", "1.1.1.1"]'
Client Info
Retorna o endereço IP, indícios de proxy, navegador e idioma do cliente que faz a chamada. Essa área é gratuita e é uma boa opção para o primeiro teste.
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_SUA_CHAVE"
Maps
Busca de lugares, geocodificação e rotas. Há três endpoints:
GET /v1/maps/searchcomq(termo de busca) e, opcionalmente,limit(de 1 a 10) ecountry(por exemploDE)GET /v1/maps/geocodecomaddresspara ir de um endereço às coordenadas, ou comlatelngpara o caminho inversoGET /v1/maps/directionscomoriginedestination, cada um como "longitude,latitude", e opcionalmenteprofile(driving,driving-traffic,walking,cycling)
curl "https://api.flowdata.one/v1/maps/geocode?address=Alexanderplatz%201,%20Berlin" \
-H "Authorization: Bearer fd_SUA_CHAVE"
Email Verifier
Verifica se um endereço de e-mail pode receber mensagens, por exemplo antes de incluí-lo na sua lista de newsletter. A resposta traz o endereço verificado (email_address) e o resultado (status e result). A chave sempre vai no cabeçalho, nunca na URL:
curl "https://api.flowdata.one/v1/email-verification/name%40example.com" \
-H "Authorization: Bearer fd_SUA_CHAVE"
A API responde a um endereço em formato inválido com HTTP 400.
YouTube
Retorna métricas de um canal do YouTube. Como identificador, informe o handle (por exemplo @YouTube) ou o ID do canal.
curl "https://api.flowdata.one/v1/youtube/stats/@YouTube" \
-H "Authorization: Bearer fd_SUA_CHAVE"
Processamento de mídia
Redimensiona e comprime vídeos, imagens e áudio, aplica marcas d'água e gera miniaturas. Diferente das outras áreas, o processamento de mídia funciona com trabalhos que rodam em segundo plano. Para começar, veja Iniciar um trabalho de mídia.
Bom saber
- Você paga conforme o uso: por 1.000 requisições bem-sucedidas nas áreas de dados e por minuto de saída iniciado ou por imagem no processamento de mídia. O Client Info é gratuito. Requisições com falha, buscas no Maps sem resultado e o resultado de e-mail
unknownnão custam nada. Os valores estão na página de preços. - Cada requisição aparece no registro da respectiva área, assim você vê na hora se sua integração está chamando corretamente, veja Estatísticas e registro de chamadas.
- Chame as APIs sempre a partir do seu servidor, para que sua chave não vá parar no navegador.