终端适配API列表
目录 |
终端适配服务API
请求格式
说明
目前只支持POST方法,
第三方请求的数据经过POST方法提交需要的数据,获取需要的数据。
所有的参数都需要是UTF-8编码。
HTTP请求方式 | 接口URL
POST https://openapi.baidu.com/rest/2.0/wise/adapt
平台系统请求参数
参数名 | 类型 | 是否必需 | 描述 |
---|---|---|---|
access_token | string | 是 | 开发者授权token,获取方法参见:如何获取Access Token |
注:获取到Access Token后,需要申请开通wise_adapt权限才能使用终端适配服务,请将站点的名称、平台应用id及具体的用途发送邮件至wangxu02@baidu.com。
业务请求参数
参数名 | 类型 | 是否必需 | 描述 |
---|---|---|---|
lcid | string | 是 | 业务id,固定值,miad |
clientip | string | 否 | 访问者的ip |
user_agent | string | 否 | http header的user_agent |
accept | string | 否 | http header的accept |
accept_charset | string | 否 | http header的accept_charset |
accept_encoding | string | 否 | http header的accept_encoding |
accept_language | string | 否 | http header的accept_language |
encoding_version | string | 否 | http header的encoding_version |
drm_version | string | 否 | http header的drm_version |
x_nokia_musicshop_version | string | 否 | http header的x_nokia_musicshop_version |
q_ua | string | 否 | http header的q_ua |
x_operamini_phone_ua | string | 否 | http header的x_operamini_phone_ua |
注:传递的http头信息越多,得到的适配信息越准确。
响应格式
http status code
参考HTTP 状态码
Body
错误情况: { error_code:错误状态码 error_msg:错误状态码对应的信息 }
正确情况: { device_type :/*1:手机2:pc*/ os:/*操作系统*/ os_version:/*操作系统版本*/ browser:/*浏览器*/ browser_version:/*浏览器版本*/ model:/*机型*/ vendor:/*厂商*/ tn: /*wml|middle|touch|utouch|iphone*/ }
返回字段说明
参数名 | 类型 | 描述 |
---|---|---|
error_code | string | 失败时才有,获取数据出错时的错误码 |
error_msg | string | 失败时才有,获取数据出错时的错误信息 |
device_type | string | 1表示手机、2表示PC |
os | string | 表示操作系统 |
os_version | string | 表示操作系统版本 |
browser | string | 表示浏览器 |
browser_version | string | 表示浏览器版本 |
model | string | 机型 |
vendor | string | 厂商 |
tn | string | 版本,目前值范围:wml/middle/big/utouch/iphone,具体含义参见终端适配服务介绍 |
错误码说明
错误码(error_code) | 错误码描述信息(error_msg) |
---|---|
58000 | 参数解析失败 |
58001 | 权限认证失败 |
58002 | 请求的服务不存在 |
58003-58009 | 系统错误 |
58204 | 获取Adapt信息出错 |
使用注意事项
- 访问授权限制
获取到Access Token后,需要发送邮件至wangsu02@baidu.com申请wise-adapt权限方可使用。
- 返回数据的使用方法
站点可根据device_type确定访问是否来源于手机,若为手机,可直接根据tn参数确定适配到的手机页版式,或根据其他详细的终端信息来选择适配的版本。tn参数中的各版式说明参见终端适配服务介绍
调用示例
请求示例
POST https://openapi.baidu.com/rest/2.0/wise/adapt?
access_token=3.fa591104f9a6637d9b3647a45ebd3a96.2592000.1346575922.282335-276409&lcid=miad& user_agent=JUC%28Linux%3B+U%3B+2.2+zh-cn%3B+HTC_hero%3B+320%2A480%29UCWEB7.9.0.94%2F139%2F800
返回示例
HTTP/1.1 200 OK Content-Type: application/json;charset=utf-8 Cache-Control: no-store Pragma: no-cache { "device_type":1, "os":"android", "os_version":"2.2", "browser":"ucweb", "browser_version":"7.9", "model":"hero", "vendor":"htc", "tn ":"big", }