Dia 0
Provar acesso
Crie a chave, complete uma requisição autenticada e salve a primeira resposta com seus metadados.
Abrir etapa →guia de fluxo de trabalho API
O que você deseja construir?
Escolha o resultado mais próximo do seu trabalho. Cada caminho oferece uma requisição funcional, o que a resposta deve conter, como verificar se funcionou e o próximo passo útil.
Cinco caminhos práticos
Comece com o resultado, não com a lista de endpoints.
Selecionado: Buscar dados macro
Caminho 1
Buscar dados macro
Recupere uma série temporal limpa e mantenha os metadados de origem e qualidade ao lado dela.
Caminho 2
Planejar tarefas de lançamento
Use o calendário de lançamentos para executar tarefas direcionadas em torno de horários de publicação conhecidos.
Caminho 3
Medir surpresas
Junte previsões de pré-lançamento ao valor publicado sem introduzir viés de antecipação (lookahead bias).
Caminho 4
Receber atualizações ao vivo
Use SSE como um sinal de invalidação, depois busque o registro completo de REST.
Caminho 5
Construir um modelo macro
Transforme um pequeno grupo de indicadores relacionados em um scorecard de moeda rotulado por fonte.
Seu teste de API de 14 dias
Passe da primeira requisição para um trabalho que vale a pena manter.
O objetivo não é visitar cada página de produto. É completar um trabalho útil e autenticado de API, retornar em outro dia e sair com um conjunto de dados ou fluxo de trabalho de aplicação repetível.
Dias 1-2
Torne a requisição confiável
Resolva problemas de autenticação ou filtro e transforme o primeiro script em uma tarefa nomeada e repetível.
Abrir etapa →Dias 3-4
Adicionar tempo de lançamento
Use o calendário como uma segunda família de endpoints e agende a próxima execução útil de API.
Abrir etapa →Dias 5-7
Construir o resultado da pesquisa
Adicione expectativas ou um pequeno grupo de séries macro, então produza uma comparação, tabela ou scorecard salva.
Abrir etapa →Dias 8-10
Automatizar atualizações
Escolha REST agendados, SSE ou webhooks e complete outra execução bem-sucedida de API em um dia diferente.
Abrir etapa →Dias 11-13
Reforce o cliente
Adicione timeouts, retentativas limitadas, validação de resposta, logging seguro para credenciais e monitoramento de dados obsoletos.
Abrir etapa →Dia 14
Revisar evidências
Confirme que o API fornece um trabalho repetível que sua equipe manterá, então escolha o próximo conjunto de dados ou fluxo de trabalho de aplicação.
Abrir etapa →Primeira requisição
Buscar e salvar histórico macro
Comece com uma moeda e um indicador que você já entende. Isso torna a autenticação, o formato da resposta, a paginação e o armazenamento fáceis de verificar antes de adicionar mais séries.
Exemplo funcional
Mantenha sua chave em FXMD_API_KEY; nunca cole em controle de versão.
import os
import requests
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])Resultado esperado: Uma resposta 200 com observações recentes de inflação EUR mais metadados de resposta descrevendo a série, fonte, paginação e qualidade dos dados.
Quando o primeiro script se torna um sistema real
Resolução de problemas e orientação de produção
Use estes guias quando uma resposta falhar, não retornar dados ou precisar de controles de produção, como cache, timeouts, tentativas e entrega de eventos.
| Guia | Use quando | Começar |
|---|---|---|
| Diagnosticar uma resposta falha ou vazia | Problemas separados de autenticação, acesso, caminho, limite de taxa e disponibilidade de dados sem expor sua chave. | Abrir guia → |
| Torne um cliente API pronto para produção | Adicione timeouts, retentativas limitadas, cache, requisições condicionais e o padrão de entrega correto. | Abrir guia → |