Публично API
Nordclima предоставя публично, неаутентикирано API за продуктовия каталог, съдържанието на сайта и създаването на поръчки. Машинно четимата спецификация е в OpenAPI 3.1 формат.
Ресурси
- OpenAPI 3.1 спецификация — machine-readable (service-desc)
- API каталог по RFC 9727 — автоматично откриване
- Състояние на услугата — status
Базов адрес
https://api.nordclima.bg
Валути
Еврото е валутата на продажба. Полето price_eur_cents е каноничната стойност в евроцентове. Когато е показана равностойност в български лева, тя е само с информационна цел и е изчислена по официалния фиксиран курс 1 EUR = 1.95583 BGN.
Наличност и срок за доставка
stock_status и lead_time_days са независими: продукт може да е в наличност и въпреки това да има по-дълъг срок за доставка. Полето heating_min_operating_temp_c е null, когато производителят не публикува стойност — не приемайте 0.
Ограничения
Заявките са ограничени по IP адрес. Създаването на поръчка изисква idempotencyKey за всеки опит — повторното изпращане със същия ключ връща първоначалната поръчка вместо да създаде втора.
Крайни точки
| Метод | Път | Описание |
|---|---|---|
| GET | /health | Състояние на услугата. |
| GET | /shop/products | Списък с продукти, със странициране и филтри. |
| GET | /shop/products/{slug} | Един продукт със снимки, категории и атрибути. |
| GET | /shop/categories | Дърво на категориите. |
| GET | /shop/categories/{slug} | Продукти в категория. |
| GET | /shop/brands | Марки с брой продукти. |
| GET | /shop/blog/posts | Публикувани статии. |
| GET | /shop/blog/posts/{slug} | Една статия. |
| GET | /shop/home-sections | Подбрани секции за началната страница. |
| GET | /shop/site-content | Услуги, ЧЗВ и райони на обслужване. |
| GET | /shop/google-reviews | Отзиви от Google Places. |
| GET | /feeds/products.xml | Продуктов фийд за Google Merchant (RSS 2.0). |
| POST | /checkout/create-session | Създаване на поръчка. |
Въпроси по интеграцията: свържете се с нас.