Ден 0
Докажи достъп
Създайте ключа, изпълнете една автентифицирана заявка и запишете първия отговор с неговите метаданни.
Отвори стъпка →Ръководство за API работен процес
Какво искате да изградите?
Изберете резултата, най-близък до вашата работа. Всеки път ви дава една работна заявка, какво трябва да съдържа отговорът, как да проверите дали е проработило и следващата полезна стъпка.
Пет практически пътя
Започнете с резултата, а не със списъка с крайни интерфейси.
Selected: Receive live updates
Път 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 осигурява повтаряема работа, която вашият екип ще поддържа, след което изберете следващия набор от данни или работен процес на приложението.
Отвори стъпка →Real-time workflow
Receive release updates
A long-lived event stream can notify your application when matching macro data changes. The event is the trigger; the announcements endpoint remains the source for the full response.
Работещ пример
Запазете вашия ключ в FXMD_API_KEY; никога не го поставяйте в контрол на версиите.
curl -N --get \
"https://api.fxmacrodata.com/v1/stream/events" \
--data-urlencode "currencies=eur" \
--data-urlencode "indicators=inflation" \
--data-urlencode "api_key=$FXMD_API_KEY"Очакван резултат: A persistent filtered stream. When an event arrives, your worker fetches the related announcements endpoint and updates its local cache.
Когато първият скрипт стане реална система
Отстраняване на проблеми и производствени насоки
Използвайте тези ръководства, когато отговорът е неуспешен, не връща данни или се нуждае от производствени контроли като кеширане, изчаквания (timeouts), повторни опити и доставка на събития.
| Ръководство | Използвайте го, когато | Старт |
|---|---|---|
| Диагностициране на неуспешен или празен отговор | Разделяне на проблеми с автентикация, достъп, път, ограничаване на честотата и наличност на данни без разкриване на вашия ключ. | Отворете ръководство → |
| Направете API клиент готов за производство | Добавете тайм-аути, ограничени повторни опити, кеширане, условни заявки и правилния модел на доставка. | Отворете ръководство → |