Օր 0
Ապացուցել հասանելիությունը
Ստեղծեք բանալին, կատարեք մեկ վավերացված հարցում և պահպանեք առաջին պատասխանը իր մետատվյալներով:
Բացել քայլը →API աշխատանքային հոսքի ուղեցույց
Ի՞նչ եք ցանկանում ստեղծել:
Ընտրեք ձեր աշխատանքին ամենամոտ արդյունքը: Յուրաքանչյուր ուղի ձեզ տալիս է մեկ աշխատանքային հարցում, թե ինչ պետք է պարունակի պատասխանը, ինչպես ստուգել դրա աշխատանքը և հաջորդ օգտակար քայլը:
Հինգ գործնական ուղիներ
Սկսեք արդյունքից, այլոչ թե endpoint-ների ցանկից:
Selected: Receive live updates
Ուղի 1
Հավաքել մակրո տվյալներ
Ստացեք մաքուր ժամանակային շարք և պահպանեք աղբյուրի ու որակի մետատվյալները դրա կողքին:
Ուղին 2
Պլանավորել հրապարակման աշխատանքները
Օգտագործեք թողարկման օրացույցը՝ հայտնի հրապարակման ժամերին թիրախային գործողություններ իրականացնելու համար:
Ուղի 3
Չափել անսպասելիությունները
Միացրեք նախահանձնարարման կանխատեսումները հրապարակված արժեքին՝ առանց նախապես տեսնելու թերության (lookahead bias) ներմուծման:
Ուղի 4
Ստանալ իրական ժամանակի թարմացումներ
Օգտագործեք SSE-ը որպես անվավերացման ազդանշան, այնուհետև ստացեք ամբողջական գրառումը REST-ից:
Ուղի 5
Կառուցել մակրո մոդել
Փոքր փոխկապակցված ցուցանիշների խումբը վերածեք աղբյուրով պիտակավորված արժութային հաշվարկի:
Ձեր 14-օրյա API փորձաշրջանը
Անցեք առաջին հարցումից դեպի պահպանելու արժանի աշխատանք:
Նպատակը ոչ թե յուրաքանչյուր ապրանքի էջ այցելելն է: Նպատակն է կատարել օգտակար վավերացված API աշխատանք, վերադառնալ մեկ այլ օր և հեռանալ կրկնվող տվյալների հավաքածուով կամ աշխատանքային գործընթացով:
Օր 1-2
Դարձրեք հարցումը հուսալի
Լուծեք նույնականացման կամ զտման (filter) խնդիրները և առաջին սկրիպտը վերածեք անվանված կրկնվող առաջադրանքի:
Բացել քայլը →Օրեր 3-4
Ավելացնել հրապարակման ժամանակը
Օգտագործեք օրացույցը որպես երկրորդ endpoint ընտանիք և պլանավորեք հաջորդ օգտակար API գործարկումը:
Բացել քայլը →Օրեր 5-7
Կառուցել հետազոտական արդյունքը
Ավելացրեք սպասելիքներ կամ մակրո սերիաների փոքր խումբ, այնուհետև ստեղծեք մեկ պահպանված համեմատություն, աղյուսակ կամ հաշվեկշիռ:
Բացել քայլը →Օր 8-10
Ավտոմատացրեք թարմացումները
Ընտրեք պլանավորված REST, SSE կամ webhooks և կատարեք ևս մեկ հաջողված API գործարկում այլ օր:
Բացել քայլը →Օրեր 11-13
Ամրապնդել client-ը
Ավելացրեք timeout-ներ, սահմանափակված կրկնություններ, պատասխանի վավերացում, վավերացման անվտանգ լոգավորում և հնացած տվյալների մոնիթորինգ:
Բացել քայլը →Օր 14
Վերանայել ապացույցները
Հաստատեք, որ API-ը մատակարարում է կրկնելի աշխատանք, որը ձեր թիմը կպահպանի, այնուհետև ընտրեք հաջորդ հավելվածների հավաքածուն կամ աշխատանքային հոսքը:
Բացել քայլը →Real-time workflow
Receive release updates
A long-lived event stream can notify your application when matching macro data changes. The event is the trigger; the announcements endpoint remains the source for the full response.
Աշխատող օրինակ
Պահպանեք ձեր բանալին FXMD_API_KEY; երբեք մի տեղադրեք այն աղբյուրների վերահսկման մեջ:
curl -N --get \
"https://api.fxmacrodata.com/v1/stream/events" \
--data-urlencode "currencies=eur" \
--data-urlencode "indicators=inflation" \
--data-urlencode "api_key=$FXMD_API_KEY"Ակնկալվող արդյունք: A persistent filtered stream. When an event arrives, your worker fetches the related announcements endpoint and updates its local cache.
Երբ առաջին սկրիպտը դառնում է իրական համակարգ
Խնդիրների հարթում և արտադրական ուղեցույց
Օգտագործեք այս ուղեցույցները, երբ պատասխանը ձախողվում է, տվյալներ չի վերադարձնում կամ պահանջում է արտադրական վերահսկողություն, ինչպիսիք են caching-ը, timeout-ները, կրկնությունները և իրադարձությունների առաքումը:
| Ուղեցույց | Օգտագործեք այն, երբ | Սկսել |
|---|---|---|
| Ախտորոշել ձախողված կամ դատարկ պատասխանը | Առանձնացրեք նույնականացման, հասանելիության, ուղու, սահմանափակման (rate-limit) և տվյալների հասանելիության խնդիրները՝ առանց ձեր բանալին բացահայտելու: | Բացել ուղեցույցը → |
| Դարձրեք API հաճախորդին արտադրական պատրաստության մեջ | Ավելացնել ժամանակի սահմանափակումներ (timeouts), սահմանափակ փորձեր (bounded retries), քեշավորում, պայմանական հարցումներ և առաքման ճիշտ օրինաչափություն: | Բացել ուղեցույցը → |