Перейти до вмісту

Автентифікація

Shop API — серверна половина інтеграції. Ваш сервер (або плагін вашої платформи) викликає https://core.neocarts.com/v1/shop/* і представляється ключем магазину. Ключ і є ідентифікатором магазину: жоден запит не несе shop_id у тілі, а замовлення чи товар завжди належать тому магазину, чий ключ надіслано.

Кожен ендпоінт у цьому розділі підписаний так:

PUT/v1/shop/products/{external_id}Bearer: API-ключ магазину

«Bearer: API-ключ магазину» означає заголовок із цієї сторінки. Ліміту на кількість успішних запитів немає.

Ключ складається з префікса nc_live_ і 40 символів після нього.

  • Де взяти. Власник магазину генерує ключ у панелі магазину, Налаштування → Інтеграція, або це робить адміністратор Neocarts зі сторінки магазину. Ключ показується один раз: загублений ключ можна тільки замінити новим.
  • Один живий ключ на магазин. Перегенерація вимикає попередній ключ негайно, без перехідного періоду: інтеграція не працює, доки новий ключ не потрапить у неї. Плануйте заміну.
  • Ключ визначає магазин. Чуже замовлення чи товар відповідають 404, а не 403 — Neocarts не підтверджує, що такий обʼєкт узагалі існує.

Заголовки кожного запиту

Section titled “Заголовки кожного запиту”
Заголовок Значення
Authorization Bearer nc_live_… — обовʼязкове
Accept-Language uk або en — мова повідомлень і помилок валідації, разом із назвами полів у них. Без заголовка сервер відповідає англійською.
Content-Type application/json для запитів із тілом
Terminal window
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"}'
Статус Коли
401 ключа немає або він невідомий — в обох випадках одна й та сама відповідь {"message":"Unauthenticated."}
429 з однієї IP-адреси за хвилину зроблено 60 невдалих спроб ключа. До кінця цієї хвилини кожен запит з адреси, навіть із правильним ключем, отримує 429. Правильний ключ сам по собі ніколи не обмежується — рахуються тільки невдачі.

Shop API не віддає CORS-заголовків і призначений виключно для викликів сервер-сервер. Браузер, у якому є ключ магазину, — саме той витік, який ця схема закриває. Ніколи не передавайте ключ на сторінку, у JavaScript каталогу чи в налаштування теми.

На сторінці магазину працює віджет, якому ключ не потрібен: йому досить id замовлення, який ваш сервер отримує через Shop API і передає на сторінку.

  • 401 — зупиніться й повідомте адміністратора магазину: ключ відсутній, неправильний або вже перегенерований. Повторні запити не допоможуть.
  • 429 — перевірте ключ і зачекайте до кінця хвилини; далі запити проходять.

Повний перелік статусів і дій — у Помилках.