快速入门
3分钟完成注册、创建密钥、首次调用。
- 注册账号：访问 注册页面，填写邮箱和密码
- 创建密钥：登录后进入开发者中心，点击"创建密钥"
- 首次调用：使用 AppKey 和 AppSecret 调用 API
签名算法
所有 API 调用都需要在请求头中携带签名，用于验证调用者身份。
// 签名算法
function sign(appKey, appSecret, method, path, timestamp) {
// 拼接签名字符串
const raw = `${appKey}:${timestamp}:${method}:${path}`;
// HMAC-SHA256 签名
const signature = hmacSha256(appSecret, raw);
return signature;
}
// 请求头示例
headers = {
"X-App-Key": "your_app_key",
"X-Timestamp": "1700000000",
"X-Signature": "your_signature"
}
计费说明
免费额度：每个 API 每天都有免费调用次数，超出部分按量计费。
按量计费：超出免费额度后，按 API 单价扣费，余额不足时调用失败。
套餐说明：我们提供多种套餐，可享受折扣优惠。
错误码大全
| 错误码 | 说明 | 解决方案 |
|---|---|---|
0 |
成功 | - |
1001 |
AppKey 无效或已禁用 | 检查 AppKey 是否正确，或联系客服 |
1002 |
AppSecret 错误 | 检查 AppSecret 是否正确 |
1003 |
API 不存在或已下架 | 检查 API 端点是否正确 |
1004 |
余额不足，请充值 | 前往开发者中心充值 |
2001 |
参数格式错误 | 检查请求参数格式 |
3001 |
核验失败 | 检查输入信息是否正确 |