文档
测试

创建比赛

POST
http://t1.vdarts.tw/MemberAPI/league4Match.php

请求参数

application/x-www-form-urlencoded
参数名
类型
描述
必填
requesttype
string
add_match(值)
必填
name
string
比赛名称
必填
match_detail
json(json字符串)
比赛参数
必填
start_time
datetime
开赛时间
必填
apply_deadline
datetime
报名截止时间
必填
target_type
string
靶类型 soft(软靶) hard(硬靶)
必填
password
string
报名密码
可选
player_mode
int
人数模式
必填
application_fee
int
报名费用
必填
match_id
int
比赛id(传了这个参数就是修改不传就是添加)
可选
is_game
int
举办方是否参加比赛 1(参加) 2(不参加)
必填
device_type
string
面板类型 com(商用) home(家用) mix(混合)
必填
rounds_time
int
定制每一轮比赛开始时间(详细看示例说明)
可选
rule
int
赛制 1(1局一胜) 3(3局两胜) 5(5局三胜) 7(7局4胜)
可选
rounds_end_time
int
定制每一轮的比赛结束时长,不能小于10分钟 (秒数为单位)
可选
is_sending_creating
boolean
是否群发参赛者好友 true(是) false(否)
可选

响应参数

参数名
类型
描述
必填
code
int
0(成功) -1(失败)
必填
msg
string
详情
必填
data
array
返回的数据
必填

说明 / 示例

请求接口 ``` curl -d 'requesttype=add_match&name=比赛名称&match_detail={"rating_limit_max": "SSS28", "rating_limit_min": "N1", "elimination_system": "2", "rating_limit_offset_max": "20", "rating_limit_offset_min": "10"}&start_time=2022-02-26 00:00:00&apply_deadline=2022-02-26 00:00:00&target_type=soft&password=1111&player_mode=8&application_fee=&is_game=1&match_id=&device_type=com&rule=1&rounds_time=[{"t":"2022-02-26 00:00:00","r":1},{"t":"2022-02-26 00:30:00","r":2},{"t":"2022-02-26 01:00:00","r":3},{"t":"2022-02-26 01:30:00","r":4},{"t":"2022-02-26 02:00:00","r":5},{"t":"2022-02-26 02:30:00","r":6}]&is_sending_creating=false&rounds_end_time=&token=c086abaed79320f5a28fda2ff33b0f926e49ad209dce8adaf0522830b8f71880' http://t1.vdarts.tw/MemberAPI/league4Match.php; ``` ``` rounds_time(第一轮时间必须和比赛开始时间一样,t:时间,r:轮次): 例子1:基准时间:30分钟、赛制:3、比赛开始时间:2022-01-01 00:00:00 [ {t:'2022-01-01 00:00:00',r:1} {t:'2022-01-01 01:30:00',r:2}, //基准时间*赛制+比赛开始时间=第二轮开始时间(30*1+'2022-01-01 00:00:00'(时间戳) = 2022-01-01 01:30:00) {t:'2022-01-01 03:00:00',r:3}, {t:'2022-01-01 04:30:00',r:4}, {t:'2022-01-01 06:00:00',r:5}, {t:'2022-01-01 07:30:00',r:6}, ] 例子2:基准时间:30分钟、赛制:1、比赛开始时间:2022-01-01 00:00:00 [ {t:'2022-01-01 00:00:00',r:1}, {t:'2022-01-01 00:30:00',r:2}, {t:'2022-01-01 01:00:00',r:3}, {t:'2022-01-01 01:30:00',r:4}, {t:'2022-01-01 02:00:00',r:5}, {t:'2022-01-01 02:30:00',r:6}, ] 例子3:基准时间:30分钟、赛制:1、比赛开始时间:2022-01-01 00:00:00、额外加上自己规定时间 [ {t:'2022-01-01 00:00:00',r:1}, {t:'2022-01-01 00:40:00',r:2}, //30*1 = 30 + 10(自己定义的时间,时间范围没有规定) {t:'2022-01-01 01:10:00',r:3}, //第二轮时间+30*1 = 2022-01-01 01:20:00 {t:'2022-01-01 01:50:00',r:4}, //第三轮时间+30*1 = 2022-01-01 01:40:00 + 10分钟 {t:'2022-01-01 02:20:00',r:5}, {t:'2022-01-01 02:50:00',r:6}, ] ``` 返回参数 ``` 创建比赛成功 {"code":"0","msg":"ok","data":{"id":当前创建的比赛id}} 比赛名称已存在 {"code":"-1","msg":"match name existence!","data":[]} 开赛时间不能小于报名截止时间 {"code":"-1","msg":"start_time less than apply_deadline!","data":[]} 比赛模式错误 {"code":"-1","msg":"player_mode error!","data":[]} 设置每一轮超时时间不能小于10 {"code":"-1","msg":"Rounds_end_time error!","data":[]} 报名比赛达到上限5个 {"code":"-1","msg":"sign_up_limit","data":[]} 扣取开赛费时v币不足 {"code":"-1","msg":"Insufficient virtual currency!","data":[]} 赛制值错误 {"code":"-1","msg":"rule error!","data":[]} rounds_time 错误 1、rounds_time:Format error! 数据格式错误 2、rounds_time error! 数据不全,缺少个别轮次的时间定义 3、rounds_time key = 0: missing key name (t / r) 下标0的元素缺少 t 或 r 4、rounds_time key = 0: t value error 下标0的时间小于(上一轮时间+(基准时间*赛制) ```