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

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

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

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

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

Selected: Measure surprises

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

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

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

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

0 күні

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

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

Қадамды ашу →

Күндер 1-2

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

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

Қадамды ашу →

3-4 күндері

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

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

Қадамды ашу →

Күндер 5-7

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

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

Қадамды ашу →

Күндер 8-10

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

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

Қадамды ашу →

Күндер 11-13

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

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

Қадамды ашу →

Күн 14

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

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

Қадамды ашу →

Expectations workflow

Compare forecasts with actual releases

Use predictions before the event, preserve the forecast timestamp, then join the released observation by announcement identity for a repeatable surprise series.

20 minutes Research workflow болжамдархабарландырулар

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

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

import os
import requests

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

Күтілетін нәтиже: Recent EUR inflation release groups with source-labelled forecasts that were recorded before each announcement.

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

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

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

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