橙讯开放平台基线
首页服务端API客户端API附录橙讯官网
首页服务端API客户端API附录橙讯官网
  1. 错误码
  • 开发前准备
  • 组织自建应用对接
    • 获取访问凭证
      • 获取访问凭证
    • 单点登录
      • 概述
      • 应用单点登录
      • 管理员单点登录
    • 消息推送
      • 概述
      • 消息推送
      • 消息撤回
    • 通讯录同步
      • 概述
      • 获取通讯录
        • 获取全量通讯录
        • 获取增量通讯录
      • 回调通知
        • 回调通知说明
    • 机器人
      • 概述
      • 创建群
      • 更新群
      • 查询群信息
      • 解散群
      • 设置群公告
      • 查询机器人创建的群列表
      • 发送群消息
      • 给指定用户发送消息
    • 待办
      • 概述
      • 创建待办
      • 更新待办
      • 删除待办
      • 更新待办执行人
    • 待阅
      • 概述
      • 创建待阅
      • 更新待阅
      • 删除待阅
      • 更新待阅执行人
    • 工作台卡片
      • 概述
      • 添加应用卡片模板
      • 获取应用的卡片模板列表
      • 更新应用卡片模板
      • 删除应用卡片模板
      • 设置卡片组织级数据
      • 批量设置卡片数据(卡片数据不同)
      • 批量设置卡片数据(卡片数据相同)
    • 错误码
      • 错误码
  • 组织服务对接
    • 组织服务对接准备
    • 对接流程
      • 概述
      • 换取企业永久授权码
      • 获取访问凭证
      • 获取全量通讯录
      • 获取增量通讯录变更
      • 更新通讯录
    • 错误码
      • 错误码
  • 历史版本(不推荐)
    • 组织自建应用对接
      • 通讯录同步
        • 概述
        • 获取通讯录
          • 获取全量通讯录
          • 获取增量通讯录
        • 回调通知
          • 回调通知说明
      • 消息推送
        • 概述
        • 消息推送
  1. 错误码

错误码

错误码描述排查建议
40000无效的请求请查看调用参数和调用路径是否正确
49000access_token无效请检查access_token是否正确或者重新获取,如果重新获取失败,可以根据错误信息联系组织管理员协助确认。
可能导致access_token失效的原因有:
1.access_token已过期;
2.应用已停用;
3.应用被删除;
4.组织被禁用;
49001API 调用次数超出限制请参考访问频率限制说明控制接口调用频率,如有特殊需求请联系橙讯客服处理
50000服务器内部错误请联系橙讯客服协助调查
50001加密失败请查看加密方式、加密参数是否正常
50100组织id无效组织id为空或者组织不存在,请联系组织管理员确认组织id是否正确
50101组织被禁用请联系组织管理员确认组织是否已被注销或解散
50205应用已停用请联系组织管理员确认该应用是否存在或已停用,如均正常请联系橙讯客服
50403禁止访问该接口请查看应用调用接口是否正确
50420access_token无效请检查access_token是否正确或者重新获取,如果重新获取失败,可以根据错误信息联系组织管理员协助确认。
可能导致access_token失效的原因有:
1.access_token已过期;
2.应用已停用;
3.应用被删除;
4.组织被禁用;
50421access_token无效请检查access_token是否正确或者重新获取,如果重新获取失败,可以根据错误信息联系组织管理员协助确认。
可能导致access_token失效的原因有:
1.access_token已过期;
2.应用已停用;
3.应用被删除;
4.组织被禁用;
50423oauth_code无效请确认oauth_code是否正确或过期,可以重新获取
50424oauth_code无效请确认oauth_code是否正确或过期,可以重新获取
50426recipients不合法,有错误的用户id或者用户状态异常请检查recipients中的accountId是否正确,accountId可以通过全量或增量通讯录接口获取
50427recipients不合法,有错误的手机号请检查recipients中的手机号是否正确
50429应用没有支持对应的终端该应用不支持当前终端,请联系组织管员确认橙讯管理后台上该应用所支持的发布终端
50430recipients不能为空请检查recipients是否为空
50431recipients不能超过上限请检查recipients数量是否超过开发平台接口说明中的数量限制
50432badge_number和message不能为空请检查badge_number和message是否为空
50433通讯录未启用请联系组织管理员确认该应用是否开启了通讯录同步
50450应用已停用请联系组织管理员确认该应用是否存在或已停用,如均正常请联系橙讯客服
50474机器人未开启请联系组织管理员确认该应用机器人功能是否启用
50475群名称不合法请确认群名称是否满足以下要求:
群名称不超过32字符,1个汉字=2字符,1个数字/字母=1字符,禁止输入/ \ % emoji
50476群主不合法请确认群组id是否为空以及是否正确,可以通过获取通讯录接口或联系组织管理员两种方式确认该员工id是否存在
50477群成员不合法请确认群成员id是否正确,可以通过获取通讯录接口或联系组织管理员两种方式确认该员工id是否存在
50478群成员总数不能大于998请确认群成员数量是否大于998
50479群公告不合法请确认群公告内容是否为字符类型,长度是否超过600
50480查询参数不合法请检查请求参数或路径中群id是否为空以及是否正确,可通过查询指定群信息或分页查询群列表接口确认群是否存在
50481消息不合法请确认消息内容是否为空、长度是否超过1500个字符
50482员工不合法请确认员工id是否为空以及是否正确,可以通过获取通讯录接口或联系组织管理员两种方式确认该员工id是否存在
50483群组不存在请确认群id是否为空以及是否正确,可以通过查询指定群信息或分页查询群列表接口确认群id是否存在
50484机器人账号已被冻结请联系橙讯客服处理
50485应用机器人建群数量超过上限可以通过分页查询群列表接口确认群数量,请确认该应用建群数量不超过限制的数量上限,或者联系橙讯客服
50487群主未激活请联系组织管理员确认群主是否激活
50488机器人不在群内请联系橙讯客服处理
50489机器人账号已过期请联系橙讯客服处理
50494消息接收人不能超过100人请确人消息接收人数是否超过100
50495消息接收人不能为空请确认消息接收人是否为空
50498不允许发送敏感词消息请检查发送的消息内容中是否包含敏感词
50701version不正确请确认version是否正确,或者重新调用获取全量通讯录接口获取最新的version以备下次获取增量通讯录使用
50702数据太多,请全量拉取请通过获取全量通讯录接口获取最新的通讯录
50800企业应用授权停用请联系组织管理员确认该应用是否存在,如已存在请联系橙讯客服
50801企业应用未授权请联系组织管理员确认该应用是否存在,如已存在请联系橙讯客服
53131app没有开启相应权限请联系组织管理员确认是否具备对应接口的权限或对应的功能是否开启,或者联系橙讯客服协调处理
53139应用未开启该接口调用权限请联系组织管理员检查应用是否开启对应接口权限
54201待办不存在请确认待办id是否正确或者该待办已删除
54202待办已存在已创建过相同id的待办,请更换新的待办id
54203待办正在被编辑该待办正在被其它请求操作,请等待几秒钟后再次尝试调用
54204待办执行人不能为空请检查待办执行人列表是否为空
54205待办执行人超过1000请确认执行人数量是否超过1000
54206待办跳转Action不能为空请检查待办跳转Action是否为空
54207待办标题不能为空请检查待办标题是否为空
54208待办标题长度不能超过200请确认待办标题长度是否超过200
54209待办详情长度不能超过500请确认待办标题长度是否超过500
54210待办提醒时间不得晚于结束时间请确认待办提醒时间是否晚于结束时间
54211敏感词校验失败请联系橙讯客服处理
54212待办标题或详情中不能存在敏感词请检查待办标题或详情中是否存在敏感词
54213待办id不能为空请检查待办id是否为空
54214待办id长度不能超过256请检查待办id长度是否超过256
54215待办提醒时间或结束时间格式不正确请检查待办提醒时间或结束时间格式是否正确,正确时间格式应为"yyyy-MM-dd HH:mm:ss Z",例如"2024-07-10 08:00:00 +0800"
54216待办提醒时间与结束时间时区不一致请检查待办提醒时间与结束时间时区是否一致
54400卡片模板类型不能为空请检查模版类型是否为空
54401卡片模板类型不支持请检查卡片模板类型是否为当前支持的模版类型,当前支持的类型为:LIST 、KEYDATA
54404操作失败,该应用已存在一个卡片模板请确保应用仅存在一个应用卡片模板
54405操作失败,还未设置卡片模板。请确保应用已经设置了应用卡片模板
54406操作失败,卡片模板ID异常请确认使用正确的卡片模板ID,或者重新查询应用卡片模板ID
54408卡片模板数据格式异常请检查提交的卡片模板默认数据格式是否符合格式要求
54410卡片数据和模板不匹配请确认卡片数据中的类型与使用的卡片模板类型一致
54411卡片数据格式错误请确认卡片数据格式与使用的卡片模板类型数据格式一致
54413卡片数据缺少必要account_id 卡片数据缺少必要account_id
54414卡片数据缺少必要的enterprise_id 卡片数据缺少必要的enterprise_id
54415只能设置一种卡片模板请查看应用模板数据,并确保应用卡片模板只有一种。
54416更新的卡片数量超出用户数量限制请确保更新卡片的用户数量不超过接口规定的数量限制
54417卡片关键数据数量超出限制。请确保卡片关键数据数量符合对应类型限制要求
54418卡片列表数据数量超出限制请确保卡片列表数据数量符合对应类型限制要求
55001超出请求频率限制请检查接口请求频率是否超过已购买的接口频率上限
修改于 2025-01-07 08:23:28
上一页
批量设置卡片数据(卡片数据相同)
下一页
组织服务对接准备
Built with