API总述
更新时间:2019-06-14
地域风向标是以数亿网民的搜索行为作为数据基础,以关键词为统计对象建立权威全面的PC端热搜词排行榜。用户可在API中携带地址位置信息(如:国家、省份、城市)、时间信息(时间起点、时间终点)、需要返回的热词数量,即可实时获取指定地区在指定时间段内的百度热搜词排行榜。
调用方式
通用约定
- 所有编码都采用UTF-8
- 日期格式采用yyyy-MM-dd方式,如2015-08-10
-
Content-type为application/x-www-form-urlencoded
- object类型的key必须使用双引号(")括起来
公共请求头
头域(Header) | 是否必须 | 说明 |
---|---|---|
Authorization | 必须 | 包含Access Key与请求签名 |
Host | 必须 | 包含API的域名,地域风向标的服务域名为:trends.baidubce.com |
Content-Type | 可选 | application/x-www-form-urlencoded |
Accept | 必须 | 此处需填写'/' |
公共响应头
头域(Header) | 说明 |
---|---|
Content-Type | application/x-www-form-urlencoded |
x-bce-request-id | 服务后端生成,并自动设置到响应头域中 |
响应状态码
返回的响应状态码遵循RFC 2616 section 6.1.1
- 1xx: Informational - Request received, continuing process.
- 2xx: Success - The action was successfully received, understood, and accepted.
- 3xx: Redirection - Further action must be taken in order to complete the request.
- 4xx: Client Error - The request contains bad syntax or cannot be fulfilled.
- 5xx: Server Error - The server failed to fulfill an apparently valid request.
通用错误返回格式
当调用接口出错时,将返回通用的错误格式。HTTP的返回状态码为4xx或5xx,返回的消息体将包括全局唯一的请求、错误代码以及错误信息。调用方可根据错误码以及错误信息定位问题,当无法定位到错误原因时,可以发工单联系百度技术人员,并提供requestId以便于快速地帮助您解决问题。
消息体定义
参数名 | 类型 | 说明 |
---|---|---|
requestId | String | 请求的唯一标识 |
code | String | 错误类型代码 |
message | String | 错误的信息说明 |
错误返回示例
{
"requestId": "47e0ef1a-9bf2-11e1-9279-0100e8cf109a",
"code":"NoSuchKey",
"message":"The resource you requested does not exist"
}
公共错误码
Code | Msg |
---|---|
101 | Token错误或过期 |
200 | 请求成功 |
401 | 缺少必要参数 |
402 | 参数解析错误 |
501 | 系统错误 |
503 | 用户权限错误 |
客户问题与解决方法
综合以往经验,客户遇到的主要问题及解决方案:
问题 | 解决方法 |
---|---|
trends.baidubce.com 无法连接(HTTP响应码5xx) | 一般原因为客户未在非苏州BCC环境请求了trends.baidubce.com导致,改换苏州外的BCC即可解决。 |
云AK/SK权限认证不通过(HTTP响应码401) | 这是由于客户使用的AK/SK不正确或者通过AK/SK生成的Auth不对导致。AK/SK获取方法 Auth生成方法:请参看签名认证 |
token错误或过期 | 请使用邮件提供的user_key和user_secret生成token, 另外token会过期,请每次请求时重新生成token。 token生成算法请参见token生成算法 |
缺少必要参数 | API请求参数错误,请自查,有需要可联系工作人员客服。 |
参数解析错误 | API请求参数错误,请自查,有需要可联系工作人员客服。 |
用户权限错误 | 用户无访问该API的权限或访问了无权限的taskid。 |