Օր 0
Ապացուցել հասանելիությունը
Ստեղծեք բանալին, կատարեք մեկ վավերացված հարցում և պահպանեք առաջին պատասխանը իր մետատվյալներով:
Բացել քայլը →API աշխատանքային հոսքի ուղեցույց
Ընտրեք ձեր աշխատանքին ամենամոտ արդյունքը: Յուրաքանչյուր ուղի ձեզ տալիս է մեկ աշխատանքային հարցում, թե ինչ պետք է պարունակի պատասխանը, ինչպես ստուգել դրա աշխատանքը և հաջորդ օգտակար քայլը:
Հինգ գործնական ուղիներ
Selected: Troubleshoot a request
Ձեր 14-օրյա API փորձաշրջանը
Նպատակը ոչ թե յուրաքանչյուր ապրանքի էջ այցելելն է: Նպատակն է կատարել օգտակար վավերացված API աշխատանք, վերադառնալ մեկ այլ օր և հեռանալ կրկնվող տվյալների հավաքածուով կամ աշխատանքային գործընթացով:
Օր 0
Ստեղծեք բանալին, կատարեք մեկ վավերացված հարցում և պահպանեք առաջին պատասխանը իր մետատվյալներով:
Բացել քայլը →Օր 1-2
Լուծեք նույնականացման կամ զտման (filter) խնդիրները և առաջին սկրիպտը վերածեք անվանված կրկնվող առաջադրանքի:
Բացել քայլը →Օրեր 3-4
Օգտագործեք օրացույցը որպես երկրորդ endpoint ընտանիք և պլանավորեք հաջորդ օգտակար API գործարկումը:
Բացել քայլը →Օրեր 5-7
Ավելացրեք սպասելիքներ կամ մակրո սերիաների փոքր խումբ, այնուհետև ստեղծեք մեկ պահպանված համեմատություն, աղյուսակ կամ հաշվեկշիռ:
Բացել քայլը →Օր 8-10
Ընտրեք պլանավորված REST, SSE կամ webhooks և կատարեք ևս մեկ հաջողված API գործարկում այլ օր:
Բացել քայլը →Օրեր 11-13
Ավելացրեք timeout-ներ, սահմանափակված կրկնություններ, պատասխանի վավերացում, վավերացման անվտանգ լոգավորում և հնացած տվյալների մոնիթորինգ:
Բացել քայլը →Օր 14
Հաստատեք, որ API-ը մատակարարում է կրկնելի աշխատանք, որը ձեր թիմը կպահպանի, այնուհետև ընտրեք հաջորդ հավելվածների հավաքածուն կամ աշխատանքային հոսքը:
Բացել քայլը →Request help
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.
Աշխատող օրինակ
Պահպանեք ձեր բանալին FXMD_API_KEY; երբեք մի տեղադրեք այն աղբյուրների վերահսկման մեջ:
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])
Ակնկալվող արդյունք: 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.
Երբ առաջին սկրիպտը դառնում է իրական համակարգ
Օգտագործեք այս ուղեցույցները, երբ պատասխանը ձախողվում է, տվյալներ չի վերադարձնում կամ պահանջում է արտադրական վերահսկողություն, ինչպիսիք են caching-ը, timeout-ները, կրկնությունները և իրադարձությունների առաքումը:
| Ուղեցույց | Օգտագործեք այն, երբ | Սկսել |
|---|---|---|
| Ախտորոշել ձախողված կամ դատարկ պատասխանը | Առանձնացրեք նույնականացման, հասանելիության, ուղու, սահմանափակման (rate-limit) և տվյալների հասանելիության խնդիրները՝ առանց ձեր բանալին բացահայտելու: | Բացել ուղեցույցը → |
| Դարձրեք API հաճախորդին արտադրական պատրաստության մեջ | Ավելացնել ժամանակի սահմանափակումներ (timeouts), սահմանափակ փորձեր (bounded retries), քեշավորում, պայմանական հարցումներ և առաքման ճիշտ օրինաչափություն: | Բացել ուղեցույցը → |