鉴权与 API Key

请求地址#

统一请求地址：https://api.zleap.com。各接口页面列出具体路径和请求格式，所有请求均通过 HTTPS 发送。

文档页面用于阅读接口说明。发送业务请求时，使用上述 API 地址及对应接口路径。

鉴权方式#

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

上传文件时使用 multipart/form-data，让客户端自动生成 boundary，不要手动把 Content-Type 设置成 application/json。

权限与余额#

Key 必须已启用，并包含目标 API 的使用权限。不同 Key 可用于开发、生产或不同应用，分别设置使用范围和消费限额。

账户余额、Key 的消费限额、接口访问权限是不同条件。遇到鉴权、余额或权限错误，应根据错误处理区分排查。

保存和轮换#

将 Key 保存在服务端环境变量或密钥管理服务中。客户端通过你自己的服务调用，不向浏览器暴露 Key。

泄露后先停用旧 Key，再创建新 Key 并更新部署配置。Key 轮换不会自动修改应用中的旧配置。向支持人员提供请求编号即可，不应发送完整 Key。