API для CRM, 1С и своих скриптов

Всё, что вы делаете в приложении KASPIRACE, можно делать и через API: менять минимальные цены, остатки на складах, включать турбо, смотреть цены конкурентов и заказы. Так вашу CRM, 1С или свой скрипт можно связать с ботом: например, CRM сама отправляет новые остатки и минимальные цены, когда меняется закупка.

API нужен тому, кто настраивает вашу программу, — вам или вашему программисту. Чтобы бот работал, API не нужен.

Как создать ключ

1. Откройте раздел «Автоматизация (API)» в меню слева. На телефоне нажмите на свой аватар вверху экрана и выберите «Автоматизация (API)».
2. Нажмите «Создать ключ».
3. Введите название, чтобы потом понимать, какая программа пользуется ключом. Например, «CRM — остатки».
4. Выберите магазины: «Все магазины» (и те, что вы подключите позже) или «Только выбранные».
5. Выберите доступ и нажмите «Создать ключ».
6. Скопируйте ключ и сохраните его в своей программе.

Ключ показывается только один раз. Потом его нельзя посмотреть — только создать новый. Ключ начинается с kr_live_.

Какой доступ выбрать

Доступ	Что может программа
Чтение	Только смотреть: товары, цены, конкуренты, заказы, статистика.
Изменение	Чтение + менять товары: минимальная и максимальная цена, шаг, остатки, слежение, турбо.
Полный	Всё, что можно в приложении: ещё оплата, запуск и остановка бота, удаление магазина.

Давайте программе самый маленький доступ, которого ей хватает. CRM, которая отправляет остатки и минимальные цены, нужен доступ «Изменение». Ключ работает только с вашими магазинами и не может больше, чем ваш аккаунт: если вам дали доступ к чужому магазину, удалить или оплатить его через API тоже нельзя.

Подключить новый магазин и создавать ключи можно только в приложении.

Первый запрос

Адрес API — https://api.kaspirace.kz/v1. Ключ передаётся в заголовке Authorization:

curl https://api.kaspirace.kz/v1/merchants/ \
  -H "Authorization: Bearer kr_live_ВАШ_КЛЮЧ"

В ответе — ваши магазины. Их id нужен в остальных запросах. Например, так меняется минимальная цена двух товаров по SKU во всех городах:

curl -X POST https://api.kaspirace.kz/v1/merchants/1/products/bulk-update \
  -H "Authorization: Bearer kr_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"skus": ["100200300", "100200301"], "min_price": 45000}'

Полный список методов с примерами — на вкладке «Документация» в разделе «Автоматизация (API)». Там можно отправить запрос прямо из браузера и скачать описание API в формате OpenAPI (JSON) для своих инструментов.

Ограничения

• До 60 запросов в минуту на один ключ. Если больше, API отвечает кодом 429 и заголовком Retry-After — через сколько секунд можно повторить.
• Лимиты Kaspi. Kaspi принимает 2 загрузки прайса и 250 изменений цен за 30 минут на магазин. Бот сам укладывает ваши изменения в эти лимиты, поэтому частые запросы не ускорят обновление цен в Kaspi.
• Ошибки приходят в теле ответа: в поле error — описание, в поле code — код ошибки для программы:

{ "error": "invalid request body", "code": "INVALID_REQUEST_BODY" }

Как защитить ключ

Ключ даёт доступ к вашим магазинам, как пароль. Не публикуйте его и не отправляйте в чатах.

В списке ключей видно, когда каждый ключ использовался последний раз. Если ключ больше не нужен или мог попасть к посторонним, нажмите «Отозвать». Ключ перестанет работать сразу, и программы с ним больше не смогут работать с вашими магазинами. Отменить это нельзя — создайте новый ключ.