终端适配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",
}
