ChatGPT
Claude
Perplexity
Google AI Mode
Microsoft Copilot
Grok
Mistral Le ChatAPI token让你自己的网站、App或AI助手不用你的密码，就能使用你的BCL账号。你在BCL创建token，并选择每个token可以做什么。只有管理员（Admin）可以创建token。
Endpoint和请求格式，请看BCL API参考文档。要连接AI助手，请看把Claude或ChatGPT连接到BCL或Set up other AI apps。
Token在哪里
Section titled “Token在哪里”API token在Integrations页面：
-
在侧边栏前往Platform Setup → Integrations。
-
点击右上角的Developer，只显示开发者卡片。在API tokens卡片上点击Manage。如果你还没有token，按钮会显示Connect。
API tokens面板会在右边打开。它列出你的token，以及10个名额里你已经用了多少个。旁边的AI agents卡片列出你用OAuth登录连接的AI App。
创建token
Section titled “创建token”每位管理员最多可以有10个token。创建方法：
-
在API tokens面板，点击Create new API token。
-
Create New API Token面板会打开。在Token Name输入token会在哪里使用，例如“Kopi Kampung Website”。BCL会建议一个名称，你可以更改。
-
在Permissions下，只勾选App需要的权限：
权限 让token可以 用于 API Read 通过API读取表单、交易、顾客、优惠券和其他资料 报告、仪表板、把订单同步到另一个系统 API Write 通过API创建付款链接和更改资料 会创建付款链接或更新表单的网站或App MCP Read 让AI助手查询你的资料 Claude Code、Cursor、VS Code和其他AI App MCP Write 让AI助手创建和更改东西 你信任、可以让它做更改的AI App 
-
在Expiration选择token什么时候失效：Never、30 days、90 days、180 days或365 days。
-
点击Create Token。BCL会显示信息
API token "<name>" has been created.，并把token加入列表。
API权限和MCP权限是分开的。只有API Read和API Write的token不能用于AI助手，只有MCP权限的token也不能用于API。API Write本身不能读取，所以大多数情况下也要勾选API Read。Token的权限之后不能更改：请改为创建一个新token。
当你已有10个token，Create new API token按钮会隐藏。请先删除一个不再使用的token。
使用token
Section titled “使用token”Token以bcl_开头。你的系统在每个请求的Authorization header里发送它：
Authorization: Bearer bcl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAccept: application/jsonAPI的地址是https://api.bcl.my/v1。也请发送你自己的User-Agent，例如MyShop/1.0：BCL会拒绝来自脚本默认user agent的请求，例如单纯的curl或python-requests。所有endpoint都在BCL API参考文档里。
Token看到的资料和你一样。Token属于创建它的管理员，其他管理员在自己的列表里看不到。
再次查看或复制token
Section titled “再次查看或复制token”BCL会保存你的token，所以你之后可以再次查看。在API tokens面板的列表里：
- 点击View token图标（眼睛），在名称下显示token。再点击一次就会隐藏。
- 点击Copy token图标复制token。
列表有这些列：
| 列 | 显示什么 |
|---|---|
| Name | Token名称。已过期的token会在名称旁显示Expired，不能再查看或复制。 |
| Abilities | 权限：read和write用于API，mcp:read和mcp:write用于AI助手 |
| Expires | Token失效的日期，或Never |
| Last Used | App最后一次使用token的时间，或Never |
| Actions | View token、Copy token和Delete token图标 |
删除token
Section titled “删除token”删除token会切断所有使用它的App。删除方法：
-
在API tokens面板，点击该token那一行的Delete token图标（垃圾桶）。
-
在Delete API Token点击Delete Token。
所有使用这个token的App会马上失去访问权限。删除后不能恢复。如果App仍然需要访问，就创建一个新token，并放进App里。
AI agents
Section titled “AI agents”AI agents卡片在API tokens旁边，列出你用BCL账号登录（OAuth）连接的AI App，例如Claude、ChatGPT或Cursor。这些App不使用token。点击卡片上的Manage，查看每个App、它的权限、你什么时候授权，以及最后使用的时间。还没连接任何App时，按钮会显示Connect，面板会显示“No AI agents connected yet”。
要切断某个App，点击它那一行的Revoke access图标，然后点击Revoke Access。请看Disconnect an AI app。
Token就是你账号的钥匙。几个好习惯可以保护它们：
- 每个App一个token。用App的名称来命名；AI工具的话，也写上是哪台电脑。万一有一个外泄，你只删除那个token，其他的照常运作。
- 员工离职时撤销访问权限。Token和已连接的AI助手属于创建它们的管理员，其他管理员看不到。请离职的管理员先删除自己的token和AI助手，并更换所有他们持有副本的token。
- 绝对不要把token贴在公开的地方。别把它放在访客看得到的网站代码、公开的Git仓库、截图和聊天群组里。如果token外泄，马上删除它。
- 设置有效期。设为Never的token会一直有效，直到有人删除它。不时查看Last Used，删除没人使用的token。
常见问题
我要怎样拿到API key来创建自己的整合？
前往Platform Setup → Integrations，在API tokens卡片上点击Manage，然后点击Create new API token。勾选API Read；如果你的系统要创建付款链接或更改资料，也勾选API Write。
我的token不见了。我需要创建一个新的吗？
不需要。打开Integrations页面的API tokens卡片，点击该token那一行的View token或Copy token图标。BCL会保存token，所以你可以再次查看。
为什么我收到“Token does not have the 'api:write' ability”？
这个token创建时没有勾选API Write。权限之后不能更改，所以请创建一个勾选API Write的新token，再删除旧的。