使用入门
请求数据包格式规范
点睛广告系统Open API使用如下HTTP接口:
https://api.e.360.cn/{version}/{service_type}/{method}?{query_string}
所有接口调用要求采用https安全协议,
请求的 Content-Type 为 application/x-www-form-urlencoded ,
query_string由系统级参数部分和具体API调用参数部分组成,以key1=value&key2=value2&…表示,对于采用POST请求的Open API,query_string部分则是在POST请求体里。
所有查询类的Open API接口既支持POST,也支持GET方式,建议全部使用POST请求,提交类的Open API接口仅支持POST方式。
数据类型说明:
类型 | 描述 |
---|---|
string | 字符串 |
double | 浮点数,如3.15 |
date | 日期类型,如“2013-04-11” |
datetime | 带时间的日期类型,如“2013-04-11 13:43:05” (日期和时间之间有且只有一个半角空格) |
int | 整数 |
注:所有输入参数字符编码都是UTF-8格式
系统级参数:
以下参数是360搜索推广Open API平台系统定义的,所有的API调用都需要用到这些参数。系统级参数都需要放在请求头(HEADER)里进行提交(format参数除外)。
API系统级参数:
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
apiKey | String | Yes | 注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken | String | Yes | 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。该参数作为HTTP HEAD字段传递。参数获取方式见接口clientLogin。 |