推广系统接口文档
1、获得公司列表
接口地址
http://192.168.100.20:8888/company
返回格式:json
请求方式:get
请求示范
http://192.168.100.20:8888/company?status=0
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
status | int | 否 | 0=未审批,1=审批通过,2=审批未通过 |
id | int | 否 | 返回该id对应公司信息 |
上述参数为空返回所有信息 |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
id | int | 否 | 自动产生的公司ID |
name | string | 是 | 公司名称 |
contact | string | 是 | 联系人 |
tel | int | 是 | 联系电话 |
companyid | string | 是 | 公司标识 |
companykey | string | 是 | 用于API认证 |
返回示例
{ "code": 200, "message": [ { "appid": "zpoHY37u", "appkey": "undefined", "contact": "miles", "id": "1006", "name": "kingsome", "status": 0, "tel": "17771" }, { "appid": "5bOaA82t", "appkey": "undefined", "contact": "miles", "id": "1007", "name": "kingsome", "status": 0, "tel": "17771" } ] }
2、新增公司信息
接口地址
http://192.168.100.20:8888/company
返回格式:json
请求方式:post
请求示范
http://192.168.100.20:8888/company?name=kings&contact=pt&tel=1234
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
name | string | 是 | 公司名称 |
contact | string | 是 | 联系人 |
tel | string | 是 | 联系电话 |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
3、更改公司信息
接口地址
http://192.168.100.20:8888/company
返回格式:json
请求方式:put
请求示范
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
name | string | 是 | 公司名称 |
contact | string | 是 | 联系人 |
tel | string | 是 | 联系电话 |
id | int | 是 | 公司id(唯一值) |
appid | string | 是 | 公司标识 |
appkey | string | 是 | 认证用,暂无 |
status | int | 是 | 审批状态 |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
4、删除公司信息
接口地址
http://192.168.100.20:8888/company
返回格式:json
请求方式:delete
请求示范
http://192.168.100.20:8888/company?id=1006
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
id | int | 是 | 公司id(唯一值) |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
5、返回位置服务信息
接口地址
http://192.168.100.20:8888/location
返回格式:json
请求方式:get
请求示范
http://192.168.100.20:8888/location
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
gameid | int | 是 | 游戏ID |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
message | json | 是 | 所有位置信息 |
返回示例
{ "code": 200 }
6、添加位置服务信息
接口地址
http://192.168.100.20:8888/location
返回格式:json
请求方式:post
请求示范
http://192.168.100.20:8888/location
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
area | int | 是 | 区域(1=首页,2=游戏中,3=结算页,4=关闭) |
type | int | 是 | 类型(1=icon,2=banner,3=浮窗) |
int | 是 | 游戏ID |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
7、删除位置服务信息
接口地址
http://192.168.100.20:8888/location
返回格式:json
请求方式:delete
请求示范
http://192.168.100.20:8888/location
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
id | int | 是 | 需删除的位置ID |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
8、添加广告信息
接口地址
返回格式:json
请求方式:post
请求示范
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
id | int | 是 | 需删除的位置ID |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
9、变更广告信息(审批)
接口地址
返回格式:json
请求方式:put
请求示范
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
id | int | 是 | |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
10、删除广告信息
接口地址
返回格式:json
请求方式:delete
请求示范
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
id | int | 是 | 需删除的位置ID |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }
11、返回需播放的广告
接口地址
返回格式:json
请求方式:get
请求示范
请求参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
gameid | int | 是 | 游戏ID |
locationid | int | 是 | 位置ID |
返回参数说明
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | int | 是 | 返回状态 |
返回示例
{ "code": 200 }