错误码说明

明道云 API 使用统一的错误码体系，所有错误码如下：

通用错误码

错误码	说明
0	失败
1	成功
51	请求限流
10000	拒绝访问ip 受限
10001	参数错误
10002	参数值错误
10005	数据操作无权限
10006	数据已存在
10007	数据不存在或已经删除
10101	令牌不存在
10102	签名不合法
10105	用户访问令牌失效
10106	用户访问组织令牌受限

业务错误码

错误码	说明
100005	字段值重复
100006	选项数量已达上限
100007	附件数量已达上限
430013	应用未找到工作表
430014	工作表字段权限不足
430017	应用附件上传量不足
430018	草稿箱记录数量已达上限
430019	必填字段值为空
430020	子表数据错误
430021	数据不满足业务规则
430022	工作表不存在
90000	请求次数超出限制
99999	数据操作异常

错误响应格式

{
  "success": false,
  "error_code": 10101,
  "error_msg": "令牌不存在",
  "data": null
}

常见错误处理

认证错误

错误码：10101, 10102, 10105, 10106

• 检查 AppKey 和 Sign 是否正确
• 确认 Token 是否过期
• 验证签名计算是否正确

权限错误

错误码：10005, 430014

• 检查 Token 权限范围
• 确认是否有对应操作的权限
• 联系管理员调整权限

参数错误

错误码：10001, 10002

• 检查请求参数格式
• 验证必填参数是否提供
• 确认参数值是否符合要求

资源不存在

错误码：10007, 430013, 430022

• 检查资源 ID 是否正确
• 确认资源是否已被删除
• 验证应用和工作表是否存在

限流错误

错误码：51, 90000

• 降低请求频率
• 实现请求重试机制
• 使用批量接口减少请求次数

错误处理最佳实践

1. 始终检查 success 字段

   if (!response.success) {
     console.error('API 错误:', response.error_msg);
     // 根据 error_code 进行相应处理
   }

2. 实现错误重试机制

   async function requestWithRetry(url, options, maxRetries = 3) {
     for (let i = 0; i < maxRetries; i++) {
       try {
         const response = await fetch(url, options);
         const data = await response.json();
         if (data.success) return data;
         
         // 如果是限流错误，等待后重试
         if (data.error_code === 51 || data.error_code === 90000) {
           await new Promise(resolve => setTimeout(resolve, 1000 * (i + 1)));
           continue;
         }
         
         throw new Error(data.error_msg);
       } catch (error) {
         if (i === maxRetries - 1) throw error;
       }
     }
   }

3. 记录错误日志

   • 记录完整的错误信息（error_code, error_msg）
   • 包含请求参数和响应数据
   • 便于问题排查和监控

相关文档

• 错误处理指南 - 详细的错误处理方法和最佳实践
• API 配置指南 - Token 和权限配置

---

维护负责人：技术部
最后更新：2025-01-19