微投票对开发者开放了【服务端】和【客户端】两种接口。
客户端接口适用于:开发者直接使用前端页面ajax请求微投票的接口;
服务端接口适用于:开发者前端页面请求开发者的服务器,由服务器进行中转调用微投票的接口。
接口地址:
/tpopen/guestLogin
请求方式:POST
请求参数:
nickname | 必填 | string | 投票者昵称,用于后台投票统计中的显示 |
headimgurl | 必填 | string | 投票者头像,用于后台用户统计中显示 |
unique_id | 必填 | string | 唯一id,微投票用以区分是否同一个投票者 |
id | 必填 | string | 投票id |
请求header:
无
响应:
guest object 投票者信息,其中包含login_token字段,投票、评论等接口需要携带。
接口地址:
/tpoweb/getVote
/tpoopen/getVote
请求方式:GET
请求参数:
id | 必填 | string | 投票id |
请求header:
无
响应:
投票信息
接口地址:
/tpweb/getVoteItemTypes
/tpopen/getVoteItemTypes
请求方式:GET
请求参数:
id | 必填 | string | 投票id |
请求header:
无
响应:
投票选手分类
接口地址:
/tpweb/getVoteItems
/tpopen/getVoteItems
请求方式:GET
请求参数:
id | 必填 | string | 投票id |
vote_item_type_id | 选填 | int | 选手分类id |
keyword | 选填 | string | 搜索关键词 |
page | 选填 | int | 分页页码 |
order | 选填 | int | 排序 1创建时间降序 2创建时间升序 3票数降序 4票数升序 5编号降序 6编号升序 |
size | 选填 | int | 单页获取数量 |
请求header:
无
响应:
选手列表
接口地址:
/tpweb/getVoteItem
/tpopen/getVoteItem
请求方式:GET
请求参数:
id | 必填 | string | 投票id |
iid | 必填 | string | 选手id |
请求header:
无
响应:
选手
接口地址:
/tpweb/sendVote
/tpopen/sendVote
请求方式:POST
请求参数:
id | 必填 | string | 投票id |
iid | 必填 | string|array | 选手id |
ip | 服务端必填 | string | 客户端ip |
ua | 服务端必填 | string | 客户端user-agent |
is_follow | 服务端必填 | 0或1 | 服务端接口可填,客户端接口无需填写 |
is_follow参数注意事项:如果开启了关注后投票,服务端接口对接时,要自行去判断投票者是否关注了公号(链接:微信公众号平台开发文档),然后传递该值;客户端对接时,接口采用代授权方式则无需该参数,系统会调用相关接口自行判断投票者是否关注。
请求header:
Token | 必填 | string | guest的login_token |
响应:
投票结果
接口地址:
/tpweb/sendSign
/tpopen/sendSign
请求方式:POST
请求参数:
id | 必填 | string | 投票id |
upload | 选填 | array | 上传图片的id数组,第一个将会自动成为选手封面 |
title | 必填 | string | 选手标题 |
content | 选填 | string | 选手描述 |
vote_item_type_id | 选填 | string | 选手分类id |
*其它字段 | 其余字段根据vote.param.sign_form去设置 |
请求header:
Token | 必填 | string | guest的login_token |
响应:
报名结果
接口地址:
/tpweb/getComments
/tpopen/getComments
请求方式:GET
请求参数:
id | 必填 | string | 投票id |
iid | 选填 | string | 选手id |
page | 选填 | int | 分页 默认1 |
size | 选填 | int | 每页数量 默认10
电话 二维码
客服橙月
|