Для чего нужны токены доступа
Токен доступа (его также называют API-ключом) позволяет вашей собственной программе, разработчику или стороннему сервису читать данные магазина через API Storeep. У каждого токена свои разрешения, период данных и срок действия, поэтому вы можете дать каждому сервису ровно то, что ему нужно, и отозвать доступ в любой момент, не сообщая свой пароль.
Откройте Настройки > Токены доступа. Кнопка Просмотреть документацию открывает справочник API: эндпоинты, как передавать токен и лимиты запросов. Отправьте эту страницу своему разработчику.
Хотите вместо этого подключить ИИ-ассистента, например Claude или ChatGPT? Для этого токены доступа не нужны. См. Подключение ИИ-ассистента.
Создание токена
Нажмите Создать новый токен, заполните форму и нажмите Создать.
- Название токена: подпись, по которой вы узнаете его в списке, например "Синхронизация бухгалтерии". Видите ее только вы.
- Разрешения: отметьте хотя бы одно:
- Чтение товаров: список товаров, подробности, варианты и остатки.
- Чтение заказов: история заказов, подробности, статусы и позиции.
- Чтение вебхуков: просмотр настроек вебхуков и журналов доставки.
- Управление вебхуками: создание, изменение и удаление подписок на вебхуки через API.
- Доступ к данным: насколько далеко в прошлое токен может читать данные.
- Последние 24 часа: только данные, созданные за последние 24 часа. Самый безопасный вариант, подходит для синхронизации в реальном времени.
- Указать дату начала: только данные, созданные в выбранную дату или позже, которую вы указываете в Дата начала доступа к данным.
- За всё время: все ваши данные, без ограничения по дате.
- Срок действия: Не истекает или Установить дату истечения срока, чтобы выбрать дату не позднее чем через год. После этой даты токен сам перестает работать.
Скопируйте токен сразу
После нажатия Создать окно показывает Ваш токен доступа с кнопкой копирования. Этот токен показывается только один раз. Скопируйте его и храните в надежном месте, например в менеджере паролей. Storeep не сможет показать его снова. Если вы его потеряли, удалите токен и создайте новый.
Относитесь к нему как к паролю. Никогда не размещайте его в коде сайта, публичных репозиториях, на скриншотах или в сообщениях чата.
Список токенов
- Имя и дата создания.
- Разрешения: например Чтение товаров или Чтение заказов.
- Доступ к данным: Последние 24 часа, Все данные или От определенной даты.
- Срок действия: дата или Никогда.
- Последнее использование: когда сервис последний раз использовал токен, или Никогда.
Число токенов на магазин ограничено. Когда вы достигнете лимита, кнопка Создать новый токен исчезнет, пока вы не удалите один из токенов.
Изменение токена
Нажмите на токен, чтобы изменить его название, разрешения, доступ к данным или срок действия. Значение токена остается прежним, поэтому сервис, который его использует, продолжает работать по новым правилам.
Удаление токена
Отметьте один или несколько токенов и выберите Удалить токены или нажмите кнопку корзины в строке. Токен сразу перестает работать, и любой сервис, который его использует, получает ошибку.
Советы
- Давайте каждому сервису отдельный токен, чтобы можно было удалить один, не ломая остальные.
- Выбирайте самый короткий период данных, которого достаточно.
- Задавайте срок действия для фрилансеров и разовых задач.
- Токен, у которого долгое время в Последнее использование стоит Никогда, скорее всего не нужен. Удалите его.
- Чтобы Storeep сам отправлял события заказов на ваш сервер, а не сервер запрашивал их, используйте вебхуки.