Create a new tournament.
POST
https://api.challonge.com/v1/tournaments.{json|xml}
Name | Description |
---|---|
Требуется заполнить
api_key
|
Your API key (required unless you're using HTTP basic authentication) |
tournament[name]
|
Your event's name/title (Max: 60 characters) |
tournament[tournament_type]
|
Single elimination (default), double elimination, round robin, swiss |
tournament[url]
|
challonge.com/url (letters, numbers, and underscores only); when blank on create, a random URL will be generated for you |
tournament[subdomain]
|
subdomain.challonge.com/url (Requires write access to the specified subdomain) |
tournament[description]
|
Description/instructions to be displayed above the bracket |
tournament[open_signup]
|
True or false. Have Challonge host a sign-up page (otherwise, you manually add all participants) |
tournament[hold_third_place_match]
|
True or false - Single Elimination only. Include a match between semifinal losers? (default: false) |
tournament[pts_for_match_win]
|
Decimal (to the nearest tenth) - Swiss only - default: 1.0 |
tournament[pts_for_match_tie]
|
Decimal (to the nearest tenth) - Swiss only - default: 0.5 |
tournament[pts_for_game_win]
|
Decimal (to the nearest tenth) - Swiss only - default: 0.0 |
tournament[pts_for_game_tie]
|
Decimal (to the nearest tenth) - Swiss only - default: 0.0 |
tournament[pts_for_bye]
|
Decimal (to the nearest tenth) - Swiss only - default: 1.0 |
tournament[swiss_rounds]
|
Integer - Swiss only - We recommend limiting the number of rounds to less than two-thirds the number of players. Otherwise, an impossible pairing situation can be reached and your tournament may end before the desired number of rounds are played. |
tournament[ranked_by]
|
One of the following: 'match wins', 'game wins', 'points scored', 'points difference', 'custom' |
tournament[rr_pts_for_match_win]
|
Decimal (to the nearest tenth) - Round Robin "custom only" - default: 1.0 |
tournament[rr_pts_for_match_tie]
|
Decimal (to the nearest tenth) - Round Robin "custom" only - default: 0.5 |
tournament[rr_pts_for_game_win]
|
Decimal (to the nearest tenth) - Round Robin "custom" only - default: 0.0 |
tournament[rr_pts_for_game_tie]
|
Decimal (to the nearest tenth) - Round Robin "custom" only - default: 0.0 |
tournament[accept_attachments]
|
True or false - Allow match attachment uploads (default: false) |
tournament[hide_forum]
|
True or false - Hide the forum tab on your Challonge page (default: false) |
tournament[show_rounds]
|
True or false - Single & Double Elimination only - Label each round above the bracket (default: false) |
tournament[private]
|
True or false - Hide this tournament from the public browsable index and your profile (default: false) |
tournament[notify_users_when_matches_open]
|
True or false - Email registered Challonge participants when matches open up for them (default: false) |
tournament[notify_users_when_the_tournament_ends]
|
True or false - Email registered Challonge participants the results when this tournament ends (default: false) |
tournament[sequential_pairings]
|
True or false - Instead of traditional seeding rules, make pairings by going straight down the list of participants. First round matches are filled in top to bottom, then qualifying matches (if applicable). (default: false) |
tournament[signup_cap]
|
Integer - Maximum number of participants in the bracket. A waiting list (attribute on Participant) will capture participants once the cap is reached. |
tournament[start_at]
|
Datetime - the planned or anticipated start time for the tournament (Used with check_in_duration to determine participant check-in window). Timezone defaults to Eastern. |
tournament[check_in_duration]
|
Integer - Length of the participant check-in window in minutes. |
tournament[grand_finals_modifier]
|
String - This option only affects double elimination. null/blank (default) - give the winners bracket finalist two chances to beat the losers bracket finalist, 'single match' - create only one grand finals match, 'skip' - don't create a finals match between winners and losers bracket finalists |
{ "tournament": { "accept_attachments": false, "allow_participant_match_reporting": true, "anonymous_voting": false, "category": null, "check_in_duration": null, "completed_at": null, "created_at": "2015-01-19T16:47:30-05:00", "created_by_api": false, "credit_capped": false, "description": "", "game_id": 600, "group_stages_enabled": false, "hide_forum": false, "hide_seeds": false, "hold_third_place_match": false, "id": 1086875, "max_predictions_per_user": 1, "name": "Sample Tournament 1", "notify_users_when_matches_open": true, "notify_users_when_the_tournament_ends": true, "open_signup": false, "participants_count": 4, "prediction_method": 0, "predictions_opened_at": null, "private": false, "progress_meter": 0, "pts_for_bye": "1.0", "pts_for_game_tie": "0.0", "pts_for_game_win": "0.0", "pts_for_match_tie": "0.5", "pts_for_match_win": "1.0", "quick_advance": false, "ranked_by": "match wins", "require_score_agreement": false, "rr_pts_for_game_tie": "0.0", "rr_pts_for_game_win": "0.0", "rr_pts_for_match_tie": "0.5", "rr_pts_for_match_win": "1.0", "sequential_pairings": false, "show_rounds": true, "signup_cap": null, "start_at": null, "started_at": null, "started_checking_in_at": null, "state": "pending", "swiss_rounds": 0, "teams": false, "tie_breaks": [ "match wins vs tied", "game wins", "points scored" ], "tournament_type": "single elimination", "updated_at": "2015-01-19T16:57:17-05:00", "url": "sample_tournament_1", "description_source": "", "subdomain": null, "full_challonge_url": "http://challonge.com/sample_tournament_1", "live_image_url": "http://images.challonge.com/sample_tournament_1.png", "sign_up_url": null, "review_before_finalizing": true, "accepting_predictions": false, "participants_locked": true, "game_name": "Table Tennis", "participants_swappable": false, "team_convertable": false, "group_stages_were_started": false } }
<?xml version="1.0" encoding="UTF-8"?> <tournament> <accept-attachments type="boolean">false</accept-attachments> <allow-participant-match-reporting type="boolean">true</allow-participant-match-reporting> <anonymous-voting type="boolean">false</anonymous-voting> <category nil="true"/> <check-in-duration nil="true"/> <completed-at nil="true"/> <created-at>2015-01-19T16:47:30-05:00</created-at> <created-by-api type="boolean">false</created-by-api> <credit-capped type="boolean">false</credit-capped> <description></description> <game-id type="integer">600</game-id> <group-stages-enabled type="boolean">false</group-stages-enabled> <hide-forum type="boolean">false</hide-forum> <hide-seeds type="boolean">false</hide-seeds> <hold-third-place-match type="boolean">false</hold-third-place-match> <id type="integer">1086875</id> <max-predictions-per-user type="integer">1</max-predictions-per-user> <name>Sample Tournament 1</name> <notify-users-when-matches-open type="boolean">true</notify-users-when-matches-open> <notify-users-when-the-tournament-ends type="boolean">true</notify-users-when-the-tournament-ends> <open-signup type="boolean">false</open-signup> <participants-count type="integer">4</participants-count> <prediction-method type="integer">0</prediction-method> <predictions-opened-at nil="true"/> <private type="boolean">false</private> <progress-meter type="integer">0</progress-meter> <pts-for-bye>1.0</pts-for-bye> <pts-for-game-tie>0.0</pts-for-game-tie> <pts-for-game-win>0.0</pts-for-game-win> <pts-for-match-tie>0.5</pts-for-match-tie> <pts-for-match-win>1.0</pts-for-match-win> <quick-advance type="boolean">false</quick-advance> <ranked-by>match wins</ranked-by> <require-score-agreement type="boolean">false</require-score-agreement> <rr-pts-for-game-tie>0.0</rr-pts-for-game-tie> <rr-pts-for-game-win>0.0</rr-pts-for-game-win> <rr-pts-for-match-tie>0.5</rr-pts-for-match-tie> <rr-pts-for-match-win>1.0</rr-pts-for-match-win> <sequential-pairings type="boolean">false</sequential-pairings> <show-rounds type="boolean">true</show-rounds> <signup-cap nil="true"/> <start-at nil="true"/> <started-at nil="true"/> <started-checking-in-at nil="true"/> <state>pending</state> <swiss-rounds type="integer">0</swiss-rounds> <teams type="boolean">false</teams> <tie-breaks type="array"> <tie-break>match wins vs tied</tie-break> <tie-break>game wins</tie-break> <tie-break>points scored</tie-break> </tie-breaks> <tournament-type>single elimination</tournament-type> <updated-at>2015-01-19T16:57:17-05:00</updated-at> <url>sample_tournament_1</url> <description-source></description-source> <subdomain nil="true"/> <full-challonge-url>http://challonge.com/sample_tournament_1</full-challonge-url> <live-image-url>http://images.challonge.com/sample_tournament_1.png</live-image-url> <sign-up-url nil="true"/> <review-before-finalizing type="boolean">true</review-before-finalizing> <accepting-predictions type="boolean">false</accepting-predictions> <participants-locked type="boolean">true</participants-locked> <game-name>Table Tennis</game-name> <participants-swappable type="boolean">false</participants-swappable> <team-convertable type="boolean">false</team-convertable> <group-stages-were-started type="boolean">false</group-stages-were-started> </tournament>