微信投票系统

帮助中心

当前位置: 微投票 > 帮助中心 > 客户端/服务端接口列表

客户端/服务端接口列表

2019-09-23 21:02

微投票对开发者开放了【服务端】和【客户端】两种接口。

客户端接口适用于:开发者直接使用前端页面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

本篇文章是否对您有所帮助呢?

上一篇:申请开发者密钥

下一篇:签名生成方法