Ден 0
Докажи достъп
Създайте ключа, изпълнете една автентифицирана заявка и запишете първия отговор с неговите метаданни.
Отвори стъпка →Ръководство за API работен процес
Какво искате да изградите?
Изберете резултата, най-близък до вашата работа. Всеки път ви дава една работна заявка, какво трябва да съдържа отговорът, как да проверите дали е проработило и следващата полезна стъпка.
Пет практически пътя
Започнете с резултата, а не със списъка с крайни интерфейси.
Избрано: Извличане на макро данни
Път 1
Извлечете макро данни
Извлечете чиста времева редица и запазете метаданните за източника и качеството до нея.
Път 2
Планирайте задачи за публикуване
Използвайте календара на релизите, за да изпълнявате целеви задачи около известните времена за публикуване.
Път 3
Измервай изненадите
Присъединете прогнози преди релиза към публикуваната стойност, без да въвеждате пристрастие към предвид на бъдещето (lookahead bias).
Път 4
Получавайте live актуализации
Използвайте SSE като сигнал за инвалидиране, след което извлечете пълния запис от REST.
Път 5
Изградете макро модел
Превърнете малка група свързани индикатори в резултатска карта на валутите с етикетирани източници.
Вашият API пробен период от 14 дни
Преминете от първо искане към работа, която си струва да се поддържа.
Целта не е да посетите всяка продуктова страница. Целта е да завършите полезна автентицирана API работа, да се върнете в друг ден и да си тръгнете с повтаряем набор от данни или работен процес на приложение.
Дни 1-2
Направете заявката надеждна
Решаване на проблеми с автентикация или филтриране и превръщане на първия скрипт в именована повтаряема задача.
Отвори стъпка →Дни 3-4
Добавете време на оповещение
Използвайте календара като втори клас крайни точки и планирайте следващото полезно изпълнение на API.
Отвори стъпка →Дни 5-7
Изградете резултата от проучването
Добавете очаквания или малка група макро серии, след което генерирайте едно запазено сравнение, таблица или резултатска карта.
Отвори стъпка →Дни 8-10
Автоматизирайте актуализациите
Изберете планирани REST, SSE или webhooks и завършете още едно успешно изпълнение на API в друг ден.
Отвори стъпка →Дни 11-13
Укрепете клиента
Добавете изчаквания (timeouts), ограничени повторения, валидация на отговори, безопасно логване на данни и мониторинг на остарели данни.
Отвори стъпка →Ден 14
Прегледай доказателствата
Потвърдете, че API осигурява повтаряема работа, която вашият екип ще поддържа, след което изберете следващия набор от данни или работен процес на приложението.
Отвори стъпка →Първа заявка
Извлечете и запишете макро история
Започнете с една валута и индикатор, които вече разбирате. Това прави автентикацията, формата на отговора, пагинацията и съхранението лесни за проверка, преди да добавите повече серии.
Работещ пример
Запазете вашия ключ в 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])Очакван резултат: A 200 отговор с последни EUR наблюдения за инфлацията плюс метаданни на отговора, описващи поредицата, източника, пагинацията и качеството на данните.
Когато първият скрипт стане реална система
Отстраняване на проблеми и производствени насоки
Използвайте тези ръководства, когато отговорът е неуспешен, не връща данни или се нуждае от производствени контроли като кеширане, изчаквания (timeouts), повторни опити и доставка на събития.
| Ръководство | Използвайте го, когато | Старт |
|---|---|---|
| Диагностициране на неуспешен или празен отговор | Разделяне на проблеми с автентикация, достъп, път, ограничаване на честотата и наличност на данни без разкриване на вашия ключ. | Отворете ръководство → |
| Направете API клиент готов за производство | Добавете тайм-аути, ограничени повторни опити, кеширане, условни заявки и правилния модел на доставка. | Отворете ръководство → |