Diena 0
Patvirtinti prieigą
Sukurkite raktą, atlikite vieną autentikavimą patvirtintą užklausą ir išsaugokite pirmąjį atsakymą su jo metadata.
Atidaryti žingsnį →API darbo eigos vadovas
Ką norite sukurti?
Pasirinkite rezultatą, artimiausią jūsų darbui. Kiekvienas kelias suteikia jums vieną darbinę užklausą, ką turėtų veikti atsakas, kaip patikrinti, ar tai veikė, ir kitą naudingą žingsnį.
Penkios praktinės kryptys
Pradėkite nuo rezultato, o ne nuo galvos ėjus sąrašo.
Selected: Troubleshoot a request
Kelias 1
Atsiimti makro duomenis
Gaukite švarų laiko seriją ir kartu su ja išsaugokite šaltinio bei kokybės metadata.
Kelias 2
Planuoti išleidimo darbus
Naudokite išleidimų kalendorių, kad vykdytumėte tikslingus užduotis aplink žinomus paskelbimo laikus.
Kelias 3
Matuoti netiklumus
Pridėkite prieš išleidimo prognozes prie paskelbtos reikšmės nesukeliant ateities žinojimo šališkumo.
Kelias 4
Gauti gyvus atnaujinimus
Naudokite SSE kaip neegzistavimo signalą, tada ištraukite visą įrašą iš REST.
Kelias 5
Sukurti makro modelį
Paverskite nedidelę susijusių rodiklių grupę valiutos rezultatų kortele su šaltinio ženklinimu.
Jūsų 14 dienų API bandymas
Pereikite nuo pirmojo užklausos prie darbo, kurio verta laikytis.
Tikslas nėra lankytis kiekvienoje produkto puslapio. Tikslas yra atlikti naudingą autentikavusį API darbą, sugrįžti kitą dieną ir išeiti su pakartojamu duomenų rinkiniu arba programėlės darbo srautu.
Dienos 1-2
Padarykite užklausą patikimą
Išspręskite autentifikavimo arba filtravimo problemas ir paverskite pirmąjį skriptą pavadinimu pavadinta pakartojama užduotis.
Atidaryti žingsnį →Dienos 3-4
Pridėti išleidimo laiką
Naudokite kalendorių kaip antrąją galvos endpoints šeimą ir suplanuokite kitą naudingą API vykdymą.
Atidaryti žingsnį →Dienos 5-7
Sukurti tyrimo rezultatą
Pridėkite lūkesčius arba nedidelę makro serijų grupę, tada sugeneruokite vieną išliktį paliekančią palyginimą, lentelę arba scorecard'ą.
Atidaryti žingsnį →Dienos 8-10
Automatuokite atnaujinimus
Pasirinkite suplanuotą REST, SSE arba webhook'us ir atlikite kitą sėkmingą API vykdymą kitą dieną.
Atidaryti žingsnį →Dienos 11-13
Sustiprinkite klientą
Pridėkite laiko limitus (timeouts), ribotą kartojimą (bounded retries), atsako validaciją, saugų duomenų įrašymą (credential-safe logging) ir senų duomenų stebėjimą.
Atidaryti žingsnį →Diena 14
Peržiūrėti įrodymus
Patvirtinkite, kad API suteikia pakartojamą darbą, kurį jūsų komanda vykdys, tada pasirinkite kitą duomenų rinktį arba programėlės darbo srautą.
Atidaryti žingsnį →Request help
Diagnozuoti nesėkmingą arba tuščią atsakymą
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.
Veikiantis pavyzdys
Saugokite savo raktą FXMD_API_KEY; niekada neįklijuokite jo į šaltinio kontrolę.
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])Tikėtinas rezultatas: 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.
Kai pirmasis skriptas tampa tikra sistema
Problemų sprendimas ir gamybinės eksploatacijos vadovas
Naudokite šiuos vadovus, jei atsakas nepavyksta, grąžina jokių duomenų arba reikia gamybinių valdymo priemonių, tokių kaip talpinimas, laiko limitai, pakartojimai ir įvykių pristatymas.
| Gidas | Naudokite, kai | Pradėti |
|---|---|---|
| Diagnozuoti nesėkmingą arba tuščią atsakymą | Atskiri autentifikavimo, prieigos, kelio, ribojimo ir duomenų prieinamumo problemos neatskleidžiant jūsų rakto. | Atidžinti vadovą → |
| Padarykite API klientą paruoštą gamybai | Pridėkite laiko apribojimus, ribotus bandymus iš naujo, kelejimą (caching), sąlyginius užklausas ir tinkamą pristatymo modelį. | Atidžinti vadovą → |