API жұмыс процесінің нұсқаулығы

Сіз не құрғыңыз келеді?

Жұмысыңызға ең жақын нәтижені таңдаңыз. Әрбір жол сізге бір жұмыс істейтін сұранысты, жауапта не болуы керектігін, оның жұмыс істегенін қалай тексеруді және келесі пайдалы қадамды ұсынады.

Бес практикалық жол

Endpoint тізімінен емес, нәтижеден бастаңыз.

Таңдалды: макро деректерді алу

Сіздің 14 күндік API сынақ мерзіміңіз

Бірінші сұраныстан сақтауға тұратын жұмысқа көшіңіз.

Мақсат — әрбір өнім бетіне кіру емес. Мақсат — пайдалы авторизацияланған API жұмысын аяқтау, басқа күні қайта келу және қайталалатын деректер жиынтығы немесе қосымша жұмыс процесімен кету.

API прогресін тексеру

0 күні

Қолжетімділікті дәлелдеу

Кілтті жасаңыз, бір аутентификацияланған сұранысты орындаңыз және алғашқы жауапты оның метадеректерімен бірге сақтаңыз.

Қадамды ашу →

Күндер 1-2

Сұранысты сенімді ету

Авторизация немесе фильтр мәселелерін шешіңіз және бірінші скриптті атаулы қайталалатын жұмысқа айналдырыңыз.

Қадамды ашу →

3-4 күндері

Релиз уақытын қосу

Күнтізбені екінші endpoint тобы ретінде пайдаланыңыз және келесі пайдалы API іске қосуын жоспарлаңыз.

Қадамды ашу →

Күндер 5-7

Зерттеу нәтижесін құрастыру

Күтулерді немесе макросериялардың шағын тобын қосыңыз, содан кейін бір сақталған салыстыруды, кестені немесе бағалау парағын жасаңыз.

Қадамды ашу →

Күндер 8-10

Жаңартуларды автоматтандыру

Жоспарланған REST, SSE немесе вебхуктарды таңдаңыз және басқа күні тағы бір сәтті API орындауын аяқтаңыз.

Қадамды ашу →

Күндер 11-13

Клиентті күшейту

Тайм-ауттарды, шектелген қайталауларды, жауапты валидациялауды, credential-safe логгингті және ескі деректерді мониторингілеуді қосыңыз.

Қадамды ашу →

Күн 14

Дәлелдерді қарау

API сіздің командаңыз сақтайтын қайталануы мүмкін жұмысты қамтамасыз ететінін растаңыз, содан кейін келесі деректер жиынтығын немесе қолданба жұмыс процесін таңдаңыз.

Қадамды ашу →

Бірінші сұраныс

Макро тарихты алу және сақтау

Сіз бұрыннан түсінетін бір валюта мен индикатордан бастаңыз. Бұл көбірек серияларды қоспас бұрын аутентификацияны, жауап пішінін, пагинацияны және сақтауды тексеруді жеңілдетеді.

10 минут Осы жерден бастаңыз хабарландырулар

Жұмыс істейтін мысал

Кілтіңізді сақтаңыз FXMD_API_KEY; оны ешқашан бастапқы кодты басқаруға қоймаңыз.

import os
import requests

response = requests.get(
    "https://api.fxmacrodata.com/v1/announcements/eur/inflation",
    params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
    timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])

Күтілетін нәтиже: Соңғы EUR инфляциялық бақылаулары бар 200 жауабы, сондай-ақ серияны, дереккөзін, беттеуді және деректер сапасын сипаттайтын жауап метадеректері.

Алғашқы скрипт нақты жүйеге айналғанда

Ақауларды жою және өндірістік нұсқаулық

Жауап сәтсіз аяқталғанда, деректер қайтармағанда немесе кэштеу, тайм-ауттар, қайта试 және оқиғаларды жеткізу сияқты өндірістік бақылаулар қажет болғанда осы нұсқаулықтарды қолданыңыз.

НұсқаулықОны мына жағдайда пайдаланыңызБастау
Сәтсіз немесе бос жауапты диагностикалау Кілтіңізді жарияламай-ақ, авторизация, қолжетімділік, жол, жылдамдық шектеуі және деректердің қолжетімділігі мәселелерін бөлек шешіңіз. Нұсқаулықты ашу →
API клиентін өндіріске дайындау Тайм-ауттарды, шектелген қайталауларды, кэштеуді, шартты сұрауларды және дұрыс жеткізу моделін қосыңыз. Нұсқаулықты ашу →