Ден 0
Докажи достъп
Създайте ключа, изпълнете една автентифицирана заявка и запишете първия отговор с неговите метаданни.
Отвори стъпка →Ръководство за API работен процес
Какво искате да изградите?
Изберете резултата, най-близък до вашата работа. Всеки път ви дава една работна заявка, какво трябва да съдържа отговорът, как да проверите дали е проработило и следващата полезна стъпка.
Пет практически пътя
Започнете с резултата, а не със списъка с крайни интерфейси.
Selected: Troubleshoot a request
Път 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 осигурява повтаряема работа, която вашият екип ще поддържа, след което изберете следващия набор от данни или работен процес на приложението.
Отвори стъпка →Request help
Диагностициране на неуспешен или празен отговор
Inspect the status and a short error body, then follow the matching fix. Never paste an API key or a full authenticated URL into a support message.
Работещ пример
Запазете вашия ключ в FXMD_API_KEY; никога не го поставяйте в контрол на версиите.
import os
import requests
key = os.getenv("FXMD_API_KEY", "").strip()
if not key:
raise RuntimeError("FXMD_API_KEY is not set")
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": key, "limit": 1},
timeout=20,
)
print(response.status_code, response.text[:300])Очакван резултат: A 200 confirms the key and path work. A 401 or 403 points to authentication or access, a 404 to the path, and a 429 to request pacing.
Когато първият скрипт стане реална система
Отстраняване на проблеми и производствени насоки
Използвайте тези ръководства, когато отговорът е неуспешен, не връща данни или се нуждае от производствени контроли като кеширане, изчаквания (timeouts), повторни опити и доставка на събития.
| Ръководство | Използвайте го, когато | Старт |
|---|---|---|
| Диагностициране на неуспешен или празен отговор | Разделяне на проблеми с автентикация, достъп, път, ограничаване на честотата и наличност на данни без разкриване на вашия ключ. | Отворете ръководство → |
| Направете API клиент готов за производство | Добавете тайм-аути, ограничени повторни опити, кеширане, условни заявки и правилния модел на доставка. | Отворете ръководство → |