Машинен достъп
JSON достъп
Интерфейс за четене на поръчки, възложители, изпълнители и обобщени статистики. Всеки клиент получава отделен API ключ с индивидуален почасов лимит.
Удостоверяване
Изпращайте предоставения ключ в HTTP заглавие X-API-Key. Ключът е обвързан с конкретно лице, организация или интеграция и може да бъде спрян отделно.
curl -H "X-API-Key: ВАШИЯТ_КЛЮЧ" \
"https://opdata.eu/api/v1/porachki?limit=25"Поддържа се и Authorization: Bearer ВАШИЯТ_КЛЮЧ.
Налични адреси
GET /api/v1/porachki | Списък и филтриране на поръчки |
GET /api/v1/porachki/{id} | Подробни данни за поръчка |
GET /api/v1/statistiki | Обобщени статистики |
GET /api/v1/vazlozhiteli | Списък на възложители |
GET /api/v1/vazlozhiteli/{id} | Профил на възложител |
GET /api/v1/izpalniteli | Списък на изпълнители |
GET /api/v1/izpalniteli/{id} | Профил на изпълнител |
Формат и ограничения
- Отговорите са UTF-8 JSON.
- Максимум 100 записа на страница.
- Почасовият лимит се определя отделно за всеки API ключ.
- Датите за машинен достъп са в ISO формат; часовата зона е
Europe/Sofia. - API ключът не трябва да се публикува в JavaScript, публично хранилище или клиентско приложение.
- Интерфейсът е само за четене и не заменя официалния източник.
- При невалиден, спрян или изтекъл ключ се връща
401, а при достигнат лимит –429.
Заявете API ключ
Подайте заявката директно през сайта. След преглед ще бъде създаден отделен ключ за конкретния проект и получател.
Всеки ключ има собствен статус, срок и лимит. Достъпът може да бъде спрян отделно, без да се засягат останалите клиенти.