Содержание статьи
API-токен Kaspi нужен для авторизации запросов интеграции к Магазину на Kaspi.kz. Если вы подключаете учётную систему, сначала уточните, какие задачи она решает и действительно ли ей нужен этот способ доступа. Токен, ссылка на XML-прайс-лист и вход в кабинет — разные части интеграции. Ниже — порядок получения токена и чек-лист проверки подключения.
Для чего используется API Kaspi
По инструкции Kaspi API позволяет работать с заказами и добавлять новые товары, а также интегрировать магазин с учётной системой. Набор доступных действий зависит от конкретных методов API и реализации программы. Само наличие токена не означает, что программа уже синхронизирует склад, считает прибыль или меняет цены. Официальная инструкция по использованию API.
До настройки сформулируйте результат простыми словами: например, получать заказы в учётную систему без ручного переноса. Затем уточните, какие статусы и периоды загружаются, как обрабатываются повторы и кто разбирает ошибки. Это помогает проверить интеграцию на конкретном сценарии, а не только увидеть сообщение «Подключено».
Где получить API-токен
- Руководитель компании входит в веб-кабинет продавца Магазина на Kaspi.kz.
- Открывает «Настройки» → «Токен API».
- Нажимает «Сформировать» и копирует токен.
- Использует его в согласованной настройке интеграции с ответственным техническим специалистом своей компании.
Kaspi указывает, что получить токен может только руководитель компании. Токен можно снова скопировать в кабинете; повторное копирование не меняет его. Если раздел недоступен сотруднику, не подбирайте обходной способ — проверьте роль и обратитесь к руководителю. Где получить токен: инструкция Kaspi.
Как обращаться с токеном
Токен — секретный код доступа. Kaspi предупреждает, что получивший его человек сможет получать информацию о заказах и товарах. Официальная инструкция допускает передачу техническому специалисту вашей компании и предостерегает от передачи посторонним. Не публикуйте токен в статье, общем чате, скриншоте или обращении без защищённого канала. Что такое токен.
Перед подключением внешнего сервиса выясните, какие данные он запрашивает, где хранит секрет и как прекращается доступ после отключения. Если схема не соответствует допустимому порядку передачи токена, сначала уточните её у поддержки Kaspi. Для диагностики обычно достаточно времени запроса, метода, кода ответа и текста ошибки с удалёнными секретами.
Как проверить подключение без изменения заказов
Начните с документированного запроса чтения, соответствующего задаче интеграции. В инструкции Kaspi предлагается протестировать API; ответ 200 означает успешное выполнение такого запроса. Для методов используются разные параметры, а токен передаётся в заголовке X-Auth-Token. Точный метод и параметры берите из текущей документации, а не из случайного примера в переписке. Как составить запрос API.
- Сопоставьте несколько заказов в кабинете и в учётной системе.
- Проверьте выбранный период и обработку нескольких страниц результатов.
- Убедитесь, что повторная синхронизация не создаёт дубли.
- Проверьте, как программа показывает ошибку и время последнего успешного получения данных.
- Согласуйте ответственность за дальнейшую поддержку интеграции.
Успешный ответ одного запроса подтверждает конкретную операцию, но не полноту выгрузки. Если часть заказов отсутствует, попросите специалиста проверить фильтры, статусы и переход между страницами. При ошибке авторизации начните с соответствия токена, заголовка и выбранного кабинета; при ошибке данных — с параметров конкретного метода. Не выполняйте изменение реального заказа только ради проверки доступа.
API-токен и XML-прайс-лист: в чём разница
API-токен авторизует программные запросы. XML-прайс-лист — файл для загрузки товарных предложений через отдельный механизм кабинета. Эти способы нельзя взаимозаменять: наличие работающего API-запроса не подтверждает обработку новой цены из файла. Если проблема связана с витриной, используйте инструкцию почему цена на Kaspi не обновляется.
Для демпинг-бота уточните способ подключения отдельно. Не считайте API-токен обязательным для любого сервиса только потому, что он работает с Kaspi. Сначала проверьте нужные функции, ограничения и доступы по чек-листу выбора демпинг-бота.
Что проверить после настройки учёта
Подключение полезно, когда данные помогают принимать решения. Для аналитики прибыли проверьте соответствие товаров, закупочных цен и фактически выданных заказов. Зафиксируйте правила учёта отмен и возвратов, а затем сверяйте результат с первичными данными магазина. Начать можно с руководства о расчёте чистой прибыли на Kaspi.
