Ден 0
Докажи пристап
Креирајте го клучот, завршете еден автентифициран барање и зачувајте го првиот одговор со неговите метаподатоци.
Отвори чекор →водич за API работен процес
Што сакате да изградите?
Изберете го исходот што е најблизок до вашата работа. Секој пат ви дава еден работен барање, што треба да содржи одговорот, како да проверите дали работи и следниот корисен чекор.
Пет практични патеки
Започнете со исходот, а не со листата на ендпоинти.
Selected: Troubleshoot a request
Патека 1
Преземи макро податоци
Преземете чиста временска серија и зачувајте ги метаподатоците за изворот и квалитетот веднаш до неа.
Патека 2
Планирај задачи за објавување
Користете го календарот на објавување за да извршите насочени задачи околу познатите времиња на објавување.
Патека 3
Мерете изненадувања
Приклучете ги пре-релизните прогнози со објавената вредност без воведување на lookahead bias.
Патека 4
Примај live ажурирања
Користете SSE како сигнал за инвалидација, потоа преземете го комплетниот запис од REST.
Патека 5
Изградете макро модел
Претворете мала група поврзани индикатори во скоркардна табла за валути означена со извор.
Вашата API пробна верзија од 14 дена
Префрлете се од прв барање на работа вредна за чување.
Целта не е да се посети секоја страница на производ. Целта е да се заврши корисна автентицирана API работа, да се се вратите друг ден и да заминете со повторлив сет на податоци или работен тек на апликација.
Денови 1-2
Направете го барањето доверливо
Резолвирајте проблеми со автентикација или филтри и претворете го првиот скрипт во именуван повторлив процес.
Отвори чекор →Денови 3-4
Додај време на објавување
Користете го календарот како втор семеен ентитет (endpoint family) и закажете го следниот корисен API процес.
Отвори чекор →Денови 5-7
Изградете го исходот од истражувањето
Додадете очекувања или мала група макро серии, а потоа генерирајте едно зачувано споредување, табела или резултатска картичка.
Отвори чекор →Денови 8-10
Автоматизирајте ажурирања
Изберете закажани REST, SSE, или webhooks и завршете уште едно успешно API извршување на друг ден.
Отвори чекор →Денови 11-13
Зајакнете го клиентот
Додадете timeout-и, ограничени повторни обиди, валидација на одговор, безбедно логување на пријава и мониторинг на застарени податоци.
Отвори чекор →Ден 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.
Кога првиот скрипт станува вистински систем
Решавање проблеми и насоки за продукција
Користете ги овие води кога одговорот не успева, не враќа податоци или бара продукциски контроли како кеширање, timeout-и, повторни обиди и испорака на настани.
| Водич | Користете го кога | Започни |
|---|---|---|
| Дијагностицирај неуспешен или празен одговор | Одвоете ги проблемите со автентикација, пристапот, патеката, ограничувањето на стапките и достапноста на податоците без да го откриете вашиот клуч. | Отвори водич → |
| Направете го API клиентот подготвен за продукција | Додај timeout-и, ограничени повторни обиди, кеширање, условни барања и соодветен модел на испорака. | Отвори водич → |