使用 REST API 连接业务系统

先确定调用边界

Crisp REST API 通过 HTTPS 访问；接入需要相应认证信息及工作空间标识。令牌属于私密配置，不应写入浏览器页面或公开仓库。

1. 明确需要读取或更新的数据。
2. 由自己的服务端持有令牌并发起请求。
3. 为测试与正式使用划分配置和访问范围。

准备身份与权限

认证参数取决于令牌类型。插件接入涉及 identifier、key 与 token tier；开发令牌和生产令牌的使用条件不同。

1. 核对 website_id 对应正确工作空间。
2. 确认令牌类型及其允许的接口范围。
3. 上线前按实际需要检查权限与配额。

完成第一个可解释的请求

1. 选择一个只读接口验证访问。
2. 记录请求方法、路径、状态码和脱敏后的响应。
3. 检查返回数据是否属于预期工作空间。
4. 通过后再增加修改操作，并为每个写入明确影响范围。

建立错误处理

1. 认证失败时核对令牌配置，避免在日志中输出私密值。
2. 权限问题先确认工作空间与允许范围。
3. 遇到限流时控制请求频率并采用退避。
4. 对超时或不确定结果，先核对实际状态，再决定是否重试写入。