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