API总述
所有文档

          舆情服务

          API总述

          地域风向标是以数亿网民的搜索行为作为数据基础,以关键词为统计对象建立权威全面的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。
          上一篇
          操作指南
          下一篇
          签名认证