Ръководство за API работен процес

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

Изберете резултата, най-близък до вашата работа. Всеки път ви дава една работна заявка, какво трябва да съдържа отговорът, как да проверите дали е проработило и следващата полезна стъпка.

Пет практически пътя

Започнете с резултата, а не със списъка с крайни интерфейси.

Selected: Plan release jobs

Вашият API пробен период от 14 дни

Преминете от първо искане към работа, която си струва да се поддържа.

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

Проверете API прогрес

Ден 0

Докажи достъп

Създайте ключа, изпълнете една автентифицирана заявка и запишете първия отговор с неговите метаданни.

Отвори стъпка →

Дни 1-2

Направете заявката надеждна

Решаване на проблеми с автентикация или филтриране и превръщане на първия скрипт в именована повтаряема задача.

Отвори стъпка →

Дни 3-4

Добавете време на оповещение

Използвайте календара като втори клас крайни точки и планирайте следващото полезно изпълнение на API.

Отвори стъпка →

Дни 5-7

Изградете резултата от проучването

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

Отвори стъпка →

Дни 8-10

Автоматизирайте актуализациите

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

Отвори стъпка →

Дни 11-13

Укрепете клиента

Добавете изчаквания (timeouts), ограничени повторения, валидация на отговори, безопасно логване на данни и мониторинг на остарели данни.

Отвори стъпка →

Ден 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.

Когато първият скрипт стане реална система

Отстраняване на проблеми и производствени насоки

Използвайте тези ръководства, когато отговорът е неуспешен, не връща данни или се нуждае от производствени контроли като кеширане, изчаквания (timeouts), повторни опити и доставка на събития.

РъководствоИзползвайте го, когатоСтарт
Диагностициране на неуспешен или празен отговор Разделяне на проблеми с автентикация, достъп, път, ограничаване на честотата и наличност на данни без разкриване на вашия ключ. Отворете ръководство →
Направете API клиент готов за производство Добавете тайм-аути, ограничени повторни опити, кеширане, условни заявки и правилния модел на доставка. Отворете ръководство →