FlowData

Como migrar minha integração para api.flowdata.one?

Publicado em 10. novembro 2026

As APIs do FlowData têm um endereço próprio: https://api.flowdata.one/v1. Os caminhos antigos em https://creativeskyline.de/api/... continuam funcionando, sem data de término, então não há pressa. A documentação e a ajuda, porém, mostram apenas o novo endereço. Para migrar, você troca o endereço; parâmetros e respostas continuam iguais.

Caminhos antigos e novos

Antigo (https://creativeskyline.de) Novo (https://api.flowdata.one)
GET /api/geolocation GET /v1/geolocation
GET /api/geolocation/{query} GET /v1/geolocation/{query}
POST /api/geolocation/batch POST /v1/geolocation/batch
GET /api/client-info GET /v1/client-info
GET /api/maps/search GET /v1/maps/search
GET /api/maps/geocode GET /v1/maps/geocode
GET /api/maps/directions GET /v1/maps/directions
GET /api/youtube/stats/{identifier} GET /v1/youtube/stats/{identifier}
GET /api/emailverification/{email} GET /v1/email-verification/{email}
/api/media/v1/... /v1/media/...

Atenção a duas diferenças: no Email Verifier, o caminho agora é email-verification, com hífen, e no processamento de mídia o v1 vem primeiro, por exemplo POST /v1/media/jobs em vez de POST /api/media/v1/jobs.

Como migrar

  1. Substitua o endereço base na sua integração conforme a tabela.
  2. Verifique se a chave está no cabeçalho Authorization: Bearer .... Uma chave na URL não é considerada.
  3. Teste o novo endereço com uma requisição gratuita:
curl "https://api.flowdata.one/v1/client-info" \
  -H "Authorization: Bearer fd_SUA_CHAVE"
  1. Verifique no registro da área se as requisições chegam como esperado. Veja como em Estatísticas e registro de chamadas.

Suas chaves atuais valem nos dois endereços. O dashboard também tem um novo endereço: flowdata.one/dashboard. Links antigos para creativeskyline.de/flowdata/... redirecionam para lá automaticamente.

Chave na URL do Email Verifier

A documentação do Email Verifier mostrava um endereço com a chave no caminho: /api/emailverification/{email}/{key}. Essa forma está obsoleta. A chave deve ir somente no cabeçalho Authorization. O novo endereço não tem mais a forma com a chave no caminho, nem outro segmento depois do e-mail.

A forma antiga continua sendo aceita para que integrações existentes não parem de repente. Porém, a parte com a chave não é considerada, fica mascarada no registro e a resposta traz o cabeçalho Deprecation. Sua requisição é autenticada apenas pelo cabeçalho. Se você enviar o endereço antigo sem o cabeçalho, recebe HTTP 401.

URLs acabam em muitos lugares que você não controla: logs de servidores e proxies, histórico do navegador, ferramentas de monitoramento e relatórios de erro. Quem encontrar a chave ali pode chamar o FlowData em seu nome e consumir seu saldo. Se ela já esteve em uma URL, troque-a:

  1. Altere o endereço na sua integração e defina o cabeçalho:
curl "https://api.flowdata.one/v1/email-verification/name%40example.com" \
  -H "Authorization: Bearer fd_SUA_CHAVE"
  1. Verifique no registro da área Email Verifier se a requisição chega com status 200.
  2. Abra Chaves de API, clique em Gerar novamente na chave afetada e confirme a caixa Gerar a chave novamente?.
  3. Copie o novo valor. Ele é exibido apenas desta vez.
  4. Informe o novo valor na sua integração.

Depois de gerar novamente, o valor anterior continua funcionando por um período de transição, e a duração aparece na caixa de diálogo. Assim você migra com calma, sem que sua integração pare. A chave mantém o nome, o limite e as estatísticas; só o valor muda. Gerar novamente só está disponível para quem criou a chave. Se outra pessoa a criou, revogue-a e crie uma nova.

Bom saber

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API