водич за API работен процес

Што сакате да изградите?

Изберете го исходот што е најблизок до вашата работа. Секој пат ви дава еден работен барање, што треба да содржи одговорот, како да проверите дали работи и следниот корисен чекор.

Пет практични патеки

Започнете со исходот, а не со листата на ендпоинти.

Selected: Plan release jobs

Вашата API пробна верзија од 14 дена

Префрлете се од прв барање на работа вредна за чување.

Целта не е да се посети секоја страница на производ. Целта е да се заврши корисна автентицирана API работа, да се се вратите друг ден и да заминете со повторлив сет на податоци или работен тек на апликација.

Проверете го API напредокот

Ден 0

Докажи пристап

Креирајте го клучот, завршете еден автентифициран барање и зачувајте го првиот одговор со неговите метаподатоци.

Отвори чекор →

Денови 1-2

Направете го барањето доверливо

Резолвирајте проблеми со автентикација или филтри и претворете го првиот скрипт во именуван повторлив процес.

Отвори чекор →

Денови 3-4

Додај време на објавување

Користете го календарот како втор семеен ентитет (endpoint family) и закажете го следниот корисен API процес.

Отвори чекор →

Денови 5-7

Изградете го исходот од истражувањето

Додадете очекувања или мала група макро серии, а потоа генерирајте едно зачувано споредување, табела или резултатска картичка.

Отвори чекор →

Денови 8-10

Автоматизирајте ажурирања

Изберете закажани REST, SSE, или webhooks и завршете уште едно успешно API извршување на друг ден.

Отвори чекор →

Денови 11-13

Зајакнете го клиентот

Додадете timeout-и, ограничени повторни обиди, валидација на одговор, безбедно логување на пријава и мониторинг на застарени податоци.

Отвори чекор →

Ден 14

Прегледај докази

Потврдете дека API обезбедува повторлива работа што вашиот тим ќе ја одржува, потоа изберете го следниот сет на податоци или работен тек на апликацијата.

Отвори чекор →

Scheduled workflow

Plan around confirmed releases

The calendar tells your scheduler when a release is expected. Your job can then fetch the full announcement record after publication instead of polling every series continuously.

15 minutes Core workflow calendarобјавувања

Работен пример

Чувајте го вашиот клуч во FXMD_API_KEY; никогаш не го поставувајте во контрола на изворниот код.

from datetime import date, timedelta
import os
import requests

events = requests.get(
    "https://api.fxmacrodata.com/v1/calendar/eur",
    params={
        "api_key": os.environ["FXMD_API_KEY"],
        "start_date": date.today().isoformat(),
        "end_date": (date.today() + timedelta(days=14)).isoformat(),
        "timezone": "UTC",
    },
    timeout=20,
).json()["data"]
print(events[:3])

Очекуван резултат: Upcoming EUR releases with dates, times, indicator paths, and confirmation fields that your scheduler can evaluate before creating a job.

Кога првиот скрипт станува вистински систем

Решавање проблеми и насоки за продукција

Користете ги овие води кога одговорот не успева, не враќа податоци или бара продукциски контроли како кеширање, timeout-и, повторни обиди и испорака на настани.

ВодичКористете го когаЗапочни
Дијагностицирај неуспешен или празен одговор Одвоете ги проблемите со автентикација, пристапот, патеката, ограничувањето на стапките и достапноста на податоците без да го откриете вашиот клуч. Отвори водич →
Направете го API клиентот подготвен за продукција Додај timeout-и, ограничени повторни обиди, кеширање, условни барања и соодветен модел на испорака. Отвори водич →