Автентифікація
Shop API — серверна половина інтеграції. Ваш сервер (або плагін вашої платформи) викликає https://core.neocarts.com/v1/shop/* і представляється ключем магазину. Ключ і є ідентифікатором магазину: жоден запит не несе shop_id у тілі, а замовлення чи товар завжди належать тому магазину, чий ключ надіслано.
Кожен ендпоінт у цьому розділі підписаний так:
«Bearer: API-ключ магазину» означає заголовок із цієї сторінки. Ліміту на кількість успішних запитів немає.
Ключ складається з префікса nc_live_ і 40 символів після нього.
- Де взяти. Власник магазину генерує ключ у панелі магазину, Налаштування → Інтеграція, або це робить адміністратор Neocarts зі сторінки магазину. Ключ показується один раз: загублений ключ можна тільки замінити новим.
- Один живий ключ на магазин. Перегенерація вимикає попередній ключ негайно, без перехідного періоду: інтеграція не працює, доки новий ключ не потрапить у неї. Плануйте заміну.
- Ключ визначає магазин. Чуже замовлення чи товар відповідають
404, а не403— Neocarts не підтверджує, що такий обʼєкт узагалі існує.
Заголовки кожного запиту
Section titled “Заголовки кожного запиту”| Заголовок | Значення |
|---|---|
Authorization |
Bearer nc_live_… — обовʼязкове |
Accept-Language |
uk або en — мова повідомлень і помилок валідації, разом із назвами полів у них. Без заголовка сервер відповідає англійською. |
Content-Type |
application/json для запитів із тілом |
curl -X PUT https://core.neocarts.com/v1/shop/products/SKU-1 \ -H "Authorization: Bearer nc_live_…" \ -H "Accept-Language: uk" \ -H "Content-Type: application/json" \ -d '{"title":"Brit Care Adult Large Breed","variant":"12 кг","image_url":"https://shop.example.com/i/brit.jpg","product_url":"https://shop.example.com/p/brit"}'const NEOCARTS_KEY = 'nc_live_…'; // лише на сервері, ніколи в браузері
const response = await fetch('https://core.neocarts.com/v1/shop/products/SKU-1', { method: 'PUT', headers: { Authorization: `Bearer ${NEOCARTS_KEY}`, 'Accept-Language': 'uk', 'Content-Type': 'application/json', }, body: JSON.stringify({ title: 'Brit Care Adult Large Breed', variant: '12 кг', image_url: 'https://shop.example.com/i/brit.jpg', product_url: 'https://shop.example.com/p/brit', }),});Відповіді 401 і 429
Section titled “Відповіді 401 і 429”| Статус | Коли |
|---|---|
401 |
ключа немає або він невідомий — в обох випадках одна й та сама відповідь {"message":"Unauthenticated."} |
429 |
з однієї IP-адреси за хвилину зроблено 60 невдалих спроб ключа. До кінця цієї хвилини кожен запит з адреси, навіть із правильним ключем, отримує 429. Правильний ключ сам по собі ніколи не обмежується — рахуються тільки невдачі. |
Без CORS
Section titled “Без CORS”Shop API не віддає CORS-заголовків і призначений виключно для викликів сервер-сервер. Браузер, у якому є ключ магазину, — саме той витік, який ця схема закриває. Ніколи не передавайте ключ на сторінку, у JavaScript каталогу чи в налаштування теми.
На сторінці магазину працює віджет, якому ключ не потрібен: йому досить id замовлення, який ваш сервер отримує через Shop API і передає на сторінку.
Що робити при помилці
Section titled “Що робити при помилці”401— зупиніться й повідомте адміністратора магазину: ключ відсутній, неправильний або вже перегенерований. Повторні запити не допоможуть.429— перевірте ключ і зачекайте до кінця хвилини; далі запити проходять.
Повний перелік статусів і дій — у Помилках.