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
- Substitua o endereço base na sua integração conforme a tabela.
- Verifique se a chave está no cabeçalho
Authorization: Bearer .... Uma chave na URL não é considerada. - Teste o novo endereço com uma requisição gratuita:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_SUA_CHAVE"
- 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:
- 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"
- Verifique no registro da área Email Verifier se a requisição chega com status 200.
- Abra Chaves de API, clique em Gerar novamente na chave afetada e confirme a caixa Gerar a chave novamente?.
- Copie o novo valor. Ele é exibido apenas desta vez.
- 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
- Mais sobre chaves, validade e limites em Criar uma chave de API do FlowData.
- A resposta do Email Verifier é igual em todas as formas. O significado está em Verificar um endereço de e-mail.
- Se sua integração ainda usa uma chave FlowSuite, você pode substituí-la ao mesmo tempo, veja Substituir chaves FlowSuite.
- O novo endereço sempre responde com JSON. Você não precisa definir um cabeçalho
Accept.