Відкриті дані: моделі й ціни для ШІ-асистентів
Моделі, ціни й петлі з цього сайту можна брати машинно: ті самі числа, що на сторінках моделей, цін і петель. Без реєстрації і ключів, тільки читання. Наприклад, кутова кабіна 900 × 900 мм, висота 2000 мм, з прозорим склом 8 мм і хромом коштує від 17 970 ₴ за комплект.
Що є
| Адреса (GET) | Що віддає |
|---|---|
/api/public/v1/models | Усі моделі: сторінка, типовий розмір, межі розмірів, ціна «від» з хромованою і чорною матовою фурнітурою, з чого складається ціна, що в неї входить, питання й відповіді. |
/api/public/v1/models/kutova | Одна модель за адресою її сторінки (kutova, u-nishu…) або за id у конфігураторі (corner, niche…). |
/api/public/v1/prices | Складові ціни: скло 8 мм за м² за типом, виріз під петлю, мінімальна площа полотна, формула. |
/api/public/v1/hinges | Серії петель: артикули, ціна в кабіні, наявність, покриття, для яких моделей. |
/api/public/v1/openapi.json | Опис API в OpenAPI 3.1. |
/.well-known/api-catalog | Каталог API за RFC 9727 (application/linkset+json). |
Приклад
curl https://dushevna.com/api/public/v1/models/kutovaСкорочена відповідь:
{
"id": "corner",
"slug": "kutova",
"name": "Кутова",
"url": "https://dushevna.com/modeli/kutova",
"typicalSize": "900 × 900 мм, висота 2000 мм",
"priceFrom": 17970,
"prices": [
{
"finish": "chrome",
"amount": 17970
},
{
"finish": "black",
"amount": 19250
}
]
}Сторінки в Markdown
Кожна публічна сторінка має чисту Markdown-версію без меню, скриптів і форм: та сама адреса з .md в кінці, головна як /index.md. Ту саму версію сторінка віддає за своєю адресою, якщо запит має заголовок Accept: text/markdown. Короткий опис усього сайту в /llms.txt.
Умови
- Безкоштовно. Вміст сайту відкритий для пошуку, відповідей ШІ і навчання моделей:
Content-Signal: search=yes, ai-input=yes, ai-train=yesу robots.txt. - Ціни «від» для типового розміру, у гривнях, округлені до 10 ₴. Точну ціну для конкретних розмірів, скла й покриття рахує конфігуратор. Посилаючись на ціну, дайте посилання на сторінку моделі.
- Кешуйте відповіді: є
Cache-ControlіETag(повторний запит зIf-None-Matchотримує 304). Моделі змінюються з оновленнями сайту, ціни й наявність щоночі. - CORS відкритий для GET з будь-якого сайту.
Чого тут немає
Персональних даних, замовлень, розрахунків клієнтів і адмінки. Через API не можна оформити замовлення чи оплатити: замовлення оформлює людина в конфігураторі. Питання про дані: контакти.