小雅OS开放平台文档

小雅OS开放平台文档

  • 快速入门
  • 客户端接入
  • 服务端接入

›API

概述

  • 服务端接入
  • 数据回传

API

  • WebSocket 协议定义
  • HTTP 协议定义
  • 调用样例
  • API 列表
  • 技能内调用
  • 错误码

错误码

接口异常时Http Code返回500,并返回ErrorResponse对象。

ErrorResponse

字段名类型描述
timestampLong毫秒时间戳
statusIntegerhttp错误状态代码
errorString业务错误代码
messageString错误描述信息
pathString访问路径

其中error取值描述信息如下:

错误码描述信息
5000未知错误
5001内部操作数据库错误
5002参数错误
5003内部http服务调用异常
5004权限验证失败
5005某资源未发现引发的错误
5006程序运行时产生的错误(比如操作数据有误导致出错)
5007频次限制引发的错误
5008内部thrift服务调用异常
5009内部技能服务调用异常
5011内部nlu服务调用异常
{
    "timestamp": 1510649738100,
    "status": 500,
    "error": "5004",
    "message": "authentication error!",
    "path": "/text/query"
}

资源获取错误

在内容技能内,在无法为用户输出资源地址用于播放时,将返回资源错误码。你可以将技能返回值解析为JSON后,通过JSON.response.data.resSoundState获得错误码。

错误码描述信息
101正常返回
102版权降级
103付费未登录状态降级
-以下错误码不返回资源地址
201无资源
202无版权
203付费未登陆状态无法输出
204已经登录,但未购买会员畅听专辑
205已经登录,但未购买会员专享专辑
206已经登录,但未购买精品专辑
207已经登录,但未购买VIP会员抢先听
← 技能内调用
  • ErrorResponse
  • 资源获取错误
北京小雅星空科技有限公司 京ICP备19010603号