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.
Selected: Troubleshoot a request
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 →Request help
Diagnosticar uma resposta falha ou vazia
Inspect the status and a short error body, then follow the matching fix. Never paste an API key or a full authenticated URL into a support message.
Exemplo funcional
Mantenha sua chave em FXMD_API_KEY; nunca cole em controle de versão.
import os
import requests
key = os.getenv("FXMD_API_KEY", "").strip()
if not key:
raise RuntimeError("FXMD_API_KEY is not set")
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": key, "limit": 1},
timeout=20,
)
print(response.status_code, response.text[:300])Resultado esperado: A 200 confirms the key and path work. A 401 or 403 points to authentication or access, a 404 to the path, and a 429 to request pacing.
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 → |