Araw 0
Patunayan ang access
Gumawa ng key, kumpletuhin ang isang authenticated request, at i-save ang unang response kasama ang metadata nito.
Buksan ang hakbang →gabay sa workflow ng API
Ano ang gusto mong buuin?
Piliin ang resulta na pinakamalapit sa iyong trabaho. Ang bawat path ay nagbibigay sa iyo ng isang working request, kung ano ang dapat lamanin ng tugon, kung paano suriin kung gumana ito, at ang susunod na kapaki-pakinabang na hakbang.
Limang praktikal na landas
Magsimula sa resulta, hindi sa listahan ng endpoint.
Selected: Troubleshoot a request
Landas 1
Kumuha ng macro data
Kumuha ng malinis na time series at panatilihin ang source at quality metadata sa tabi nito.
Landas 2
Iplano ang mga release job
Gamitin ang release calendar upang magpatakbo ng mga targeted job sa paligid ng mga kilalang publication time.
Landas 3
Sukatin ang mga surprise
Isama ang mga pre-release forecast sa published value nang hindi nagpapasok ng lookahead bias.
Landas 4
Tumanggap ng mga live update
Gamitin ang SSE bilang isang invalidation signal, pagkatapos ay kunin ang kumpletong record mula sa REST.
Landas 5
Bumuo ng isang macro model
Gawing isang source-labelled currency scorecard ang isang maliit na grupo ng mga kaugnay na indicator.
Ang iyong 14-day API trial
Lumipat mula sa unang request patungo sa isang trabahong sulit panatilihin.
Ang layunin ay hindi ang bisitahin ang bawat product page. Ito ay upang makumpleto ang kapaki-pakinabang na authenticated API work, bumalik sa ibang araw, at umalis na may repeatable dataset o application workflow.
Mga Araw 1-2
Gawing maaasahan ang request
Lutasin ang mga problema sa authentication o filter at gawing isang named repeatable job ang unang script.
Buksan ang hakbang →Mga Araw 3-4
Magdagdag ng release timing
Gamitin ang kalendaryo bilang pangalawang endpoint family at i-schedule ang susunod na kapaki-pakinabang na API run.
Buksan ang hakbang →Mga Araw 5-7
Buuin ang research output
Magdagdag ng mga ekspektasyon o isang maliit na grupo ng mga macro series, pagkatapos ay gumawa ng isang nakasave na paghahambing, table, o scorecard.
Buksan ang hakbang →Mga Araw 8-10
Awtomatikong i-update
Pumili ng scheduled REST, SSE, o webhooks at kumpletuhin ang isa pang matagumpay na API run sa ibang araw.
Buksan ang hakbang →Mga Araw 11-13
Patatagin ang client
Magdagdag ng mga timeout, bounded retries, response validation, credential-safe logging, at stale-data monitoring.
Buksan ang hakbang →Araw 14
Suriin ang ebidensya
Kumpirmahin na ang API ay nagbibigay ng repeatable job na pananatilihin ng iyong koponan, pagkatapos ay piliin ang susunod na dataset o application workflow.
Buksan ang hakbang →Request help
Suriin ang nabigong o walang lamang tugon
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.
Halimbawang gumagana
Panatilihin ang iyong key sa FXMD_API_KEY; huwag itong i-paste sa source control.
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])Inaasahang resulta: 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.
Kapag ang unang script ay naging isang tunay na system
Troubleshooting at gabay sa production
Gamitin ang mga gabay na ito kapag ang isang response ay nabigo, walang ibinalik na data, o nangangailangan ng mga production control tulad ng caching, timeouts, retries, at event delivery.
| Gabay | Gamitin ito kapag | Magsimula |
|---|---|---|
| Suriin ang nabigong o walang lamang tugon | Ihiwalay ang mga problema sa authentication, access, path, rate-limit, at data-availability nang hindi inilalantad ang iyong key. | Buksan ang gabay → |
| Gawing production-ready ang isang API client | Magdagdag ng mga timeout, bounded retry, caching, conditional request, at ang tamang delivery pattern. | Buksan ang gabay → |