SDMX API використовується для надання програмного доступу до наборів даних, наявних на порталі поширення Держстату, а саме структур даних, даних та метаданих. Доступ надається через протокол REST із можливістю отримання артефактів у форматах JSON та XML.
SDMX API v3
Технічну специфікацію SDMX 3.0 було прийнято у вересні 2021 року. Порівняно із версією SDMX API 2.1 надає доступ до більшого переліку структурних артефактів. Повний перелік змін доступний англійською за цим посиланням.
SDMX API v2.1
Технічну специфікацію SDMX 2.1 було прийнято в квітні 2012 року. Мета версії 2.1 полягає в тому, щоб зробити виконання обмеженого набору стандартних запитів простим. Крім того, на відміну від інших частин специфікації SDMX, RESTful API зосереджується виключно на отриманні даних (через HTTP GET).
Покроковий приклад застосування
На цій сторінці наведено покрокові інструкції щодо отримання структурних елементів та даних через SDMX API Держстату. Ви дізнаєтесь, як:
- отримати перелік усіх доступних потоків даних (dataflow) разом із метаданими та описом;
- переглянути структуру даних для обраного потоку (DSD) — перелік вимірів, атрибутів та їх послідовність;
- ознайомитися з концепт-схемами та довідниками, які визначають можливі значення для вимірів;
- отримати значення конкретного довідника з перекладами;
- сформувати запит для отримання самих даних (часових рядів) у форматі SDMX.
Кожен крок супроводжується прикладом запиту та поясненням, як читати відповідь сервера. Це дозволяє швидко зорієнтуватися у структурі даних та побудувати власні запити для інтеграції з системами або аналітики.