# 创建 API 密钥

> API 密钥让你自己的代码或其他系统通过 Shoprocket API 读取和更新你的店铺。在设置 > API 密钥中创建，只授予它需要的权限，并复制密钥，它只显示一次。

帮助中心 / 集成 - 更新于 2026年11月2日

API 密钥是一段秘密凭证，让程序可以通过 Shoprocket API 操作你的店铺。例如更新库存的库存系统、每晚导出订单的脚本，或开发者为你搭建的集成。所有套餐都包含 API。

每个密钥都有自己的名称和权限，所以你可以只给每个集成它需要的东西，并且停用一个密钥而不影响其他密钥。

**在你的网站上销售不需要 API 密钥。** 嵌入使用店铺的可公开密钥（以 `pk_` 开头），它已经在你粘贴的代码里，公开显示是安全的。API 密钥（以 `sk_` 开头）是保密的，只能放在服务器上。

## 开始之前

API 密钥属于 **开发者工具** 应用，和 **Webhook** 在一起。如果侧边栏的 **设置** 下看不到 **API 密钥**，请前往 **应用**，在 **开发者** 下找到 **开发者工具** 并点击 **添加**。参见 [添加和移除应用](https://shoprocket.io/zh/help/the-apps-page.md)。

## 创建密钥

1. 在后台进入 **设置 > API 密钥**，点击 **创建密钥**。
2. 输入 **名称**。按用途的集成来命名，例如“库存同步”，这样吊销时你就知道什么会停止工作。
3. 选择 **到期** 时间：**永不过期**，或 30、90、365 天后。
4. 勾选需要的权限，权限按 **商品**、**订单**、**客户**、**营销** 等分组。整组可用 **全选**，店铺能做的一切可用 **授予完全访问权限**。最安全的做法是只给密钥它所需的权限。
5. 点击 **创建密钥**。

![创建 API 密钥抽屉：名称 Inventory sync，到期设为 365 天，勾选了商品权限](https://shoprocket.io/img/help/api-keys/create-key.webp)

## 立即复制密钥

新密钥的秘密值只在屏幕顶部显示一次。点击 **复制**，把它保存在安全的地方，例如集成的设置或密码管理器，然后点击 **我已保存**。

这是秘密值唯一一次显示。Shoprocket 以无法读回的形式存储它，所以如果丢失了，请吊销该密钥并新建一个。

![刚创建的密钥，显示秘密值、复制按钮和我已保存](https://shoprocket.io/img/help/api-keys/copy-secret.webp)

## 管理密钥

列表中显示每个密钥的秘密值结尾（例如 `sk_...abc123`）、权限、创建者、到期时间和最近一次使用时间。长时间没用过的密钥通常可以吊销。

- **修改密钥名称或权限**：点击它的编辑按钮，修改后点击 **保存**。秘密值不变。
- **吊销密钥**：点击 **吊销** 并确认。密钥立即失效，使用它的集成也会停止。此操作无法撤销。

已过期或已吊销的密钥会留在列表中，标记为 **已过期** 或 **已吊销**，方便你知道它曾用于什么。

不要把密钥放在网页、应用或邮件中。任何拿到秘密值的人都能做其权限允许的任何事。如果你怀疑密钥泄露，请吊销它并新建一个。

## 开发者须知

以 Bearer 令牌的方式发送密钥。开发者指南介绍了密钥和权限、完整的 API 参考，以及如何在测试模式下试用。请参阅 [身份验证](https://shoprocket.io/docs/authentication.md) 和 [API 参考](https://shoprocket.io/docs/api.md)。

## 相关文章

- [Webhook](https://shoprocket.io/zh/help/webhooks.md)
- [Zapier](https://shoprocket.io/zh/help/zapier.md)
- [在任何网站上嵌入 Shoprocket](https://shoprocket.io/zh/help/embed-on-any-website.md)

[在后台打开 API 密钥](https://app.shoprocket.io/go/settings/api-keys)

---

- HTML version: https://shoprocket.io/zh/help/api-keys
- Language: 中文 (zh)
- Also in: [العربية](https://shoprocket.io/ar/help/api-keys.md), [Deutsch](https://shoprocket.io/de/hilfe/einen-api-schluessel-erstellen.md), [Ελληνικά](https://shoprocket.io/el/help/api-keys.md), [English](https://shoprocket.io/help/api-keys.md), [Español](https://shoprocket.io/es/ayuda/crear-una-clave-api.md), [Français](https://shoprocket.io/fr/aide/creer-une-cle-api.md), [עברית](https://shoprocket.io/he/help/api-keys.md), [हिन्दी](https://shoprocket.io/hi/help/api-keys.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/kunci-api.md), [Italiano](https://shoprocket.io/it/aiuto/creare-una-chiave-api.md), [日本語](https://shoprocket.io/ja/help/api-keys.md), [Lietuvių](https://shoprocket.io/lt/pagalba/sukurkite-api-rakta.md), [Norsk](https://shoprocket.io/nb/hjelp/opprett-en-api-nokkel.md), [Nederlands](https://shoprocket.io/nl/hulp/api-sleutel-aanmaken.md), [Polski](https://shoprocket.io/pl/pomoc/utworz-klucz-api.md), [Português](https://shoprocket.io/pt/ajuda/criar-uma-chave-de-api.md), [Română](https://shoprocket.io/ro/ajutor/creeaza-o-cheie-api.md), [Русский](https://shoprocket.io/ru/help/api-keys.md), [ไทย](https://shoprocket.io/th/help/api-keys.md), [Türkçe](https://shoprocket.io/tr/yardim/api-anahtarlari.md)
