设备认证

优质
小牛编辑
190浏览
2023-12-01

1.1. 请求认证

1.1.1. 认证方式

不管是WebSocket方式还是HTTP方式,都是在http request header里面加上Authorization Header,格式是:

authorization: key={key};device_type_id={device_type_id};device_id={device_id};service={service};version={version};time={time};sign={sign}

各个参数含义

参数类型描述默认值
keystring开放接口Key,在开放平台语音接入获取无,必填
device_type_idstring设备类型ID无,必填
device_idstring设备ID,开发者平台默认赠送10个sn,请选择任意一个无,必填
servicestringtts 或 asr无,必填
versionstring接口版本号无,必填
timestringunix时间戳无,必填
signstring由以上几项及 secret 按约定的加密方式生成无,必填
参数说明
  1. 字段 sign 计算方法:
    • 拼成如下字符串 utf8 的字符串:key={key}&device_type_id={device_type_id}&device_id={device_id}&service={service}&version={version}&time={time}&secret={secret},其中 :
    • 计算 str 字符串的 md5 值
  2. 字段 version 有 1.0 或 2.0,目前支持的协议版本:
    • 语音识别: serivce(asr), version(2)
    • 语音合成 :serivce(tts), version(1)

响应说明

  1. 当认证失败时,服务端会主动断开此连接。
  2. 确保device_id是经过认证的sn,开发者平台里面默认赠送10个已认证sn,用于测试。