首页 > 帮助文档首页 > 终端适配服务 > 终端适配API列表

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