访问令牌的用途
访问令牌(也叫 API 密钥)让你自己的软件、开发者或第三方工具通过 Storeep API 读取你店铺的数据。每个令牌都有自己的权限、数据范围和到期日期,所以你可以只给每个工具它所需要的权限,并随时移除,无需分享你的密码。
打开设置 > 访问令牌。查看文档按钮会打开 API 参考文档,包括各个接口、如何发送令牌以及请求限制。请把该页面分享给你的开发者。
想连接 Claude 或 ChatGPT 这样的 AI 助手?那不使用访问令牌。请参阅连接 AI 助手。
创建令牌
点击创建新令牌,填写表单,然后点击创建。
- 令牌名称:用于在列表中识别它的标签,例如“会计同步”。只有你能看到。
- 权限:至少勾选一项:
- 读取产品:产品列表、详情、变体和库存。
- 读取订单:订单历史、详情、状态和订单明细。
- 读取Webhook:查看 Webhook 配置和发送日志。
- 管理Webhook:通过 API 创建、更新和删除 Webhook 订阅。
- 数据访问:令牌可以读取多久以前的数据。
- 过去24小时:只读取过去 24 小时内创建的数据。最安全的选项,适合实时同步。
- 设置开始日期:只读取在你于数据访问起始日期中选择的日期当天或之后创建的数据。
- 所有时间:你的全部数据,没有日期限制。
- 到期时间:永不过期,或选择设置到期日期,挑选一年以内的某个日期。过了该日期,令牌会自动失效。
立即复制你的令牌
点击创建后,窗口会显示您的访问令牌和一个复制按钮。此令牌只显示一次。请复制并妥善保存,例如存到密码管理器中。Storeep 无法再次显示它。如果丢失了,请删除该令牌并创建一个新的。
请像对待密码一样对待它。绝不要把它放在网站代码、公开代码仓库、截图或聊天消息中。
令牌列表
- 名称,以及创建日期。
- 权限:例如产品读取或订单读取。
- 数据访问:过去24小时、所有数据,或来自某个日期。
- 到期时间:一个日期,或从不。
- 最后使用时间:工具最后一次使用该令牌的时间,或从不。
每个店铺的令牌数量有上限。达到上限后,创建新令牌按钮会消失,直到你删除一个。
编辑令牌
点击某个令牌,可以修改其名称、权限、数据访问或到期时间。令牌的值保持不变,所以使用它的工具会按新规则继续工作。
删除令牌
勾选一个或多个令牌并选择删除令牌,或使用某一行上的垃圾桶按钮。令牌会立即失效,任何使用它的工具都会收到错误。
小贴士
- 为每个工具创建单独的令牌,这样移除其中一个时不会影响其他工具。
- 选择能满足需要的最小数据范围。
- 为自由职业者和一次性工作设置到期日期。
- 如果某个令牌的最后使用时间长期显示从不,说明它可能不再需要。请删除它。
- 如果想让 Storeep 主动把订单事件推送到你的服务器,而不是由你的服务器来查询,请使用 Webhook。