{"swagger":"2.0","info":{"version":"2.0.0","title":"361 API specs"},"consumes":["application/x-www-form-urlencoded"],"produces":["application/json"],"tags":[{"name":"OAuth"},{"name":"Profile"},{"name":"Sponsored leagues"},{"name":"Team"},{"name":"Leagues"},{"name":"Matchcenter"}],"paths":{"/oauth/token":{"post":{"tags":["OAuth"],"summary":"Retrieve the access token for the app","description":"Retrieve a token using facebook login or username/password combination","parameters":[{"in":"formData","name":"grant_type","required":true,"type":"string","enum":["social","password"]},{"in":"formData","name":"client_id","required":true,"type":"integer","description":"Client ID provided by the developers"},{"in":"formData","name":"client_secret","required":true,"type":"string","description":"Client secret provided by the developers"},{"in":"formData","name":"username","type":"string","description":"Required if grant_type is password"},{"in":"formData","name":"password","type":"string","description":"Required if grant_type is password"},{"in":"formData","name":"provider","type":"string","enum":["facebook"],"description":"Required if grant_type is social"},{"in":"formData","name":"access_token","type":"string","description":"Required if grant_type is social. JSON encoded of array of [facebook access token, validated phone number]\n"}],"responses":{"200":{"description":"OK"}}}},"/oauth/token/refresh":{"post":{"tags":["OAuth"],"responses":{"200":{"description":"OK"}}}},"/oauth/tokens":{"get":{"tags":["OAuth"],"responses":{"200":{"description":"OK"}}}},"/oauth/tokens/{token_id}":{"delete":{"tags":["OAuth"],"parameters":[{"in":"path","name":"token_id","required":true,"type":"string"}],"responses":{"200":{"description":"OK"}}}},"/register":{"post":{"tags":["Profile"],"summary":"Register a new user","parameters":[{"in":"formData","name":"name","required":true,"type":"string"},{"in":"formData","name":"phone","required":true,"type":"string"},{"in":"formData","name":"password","required":true,"type":"string"},{"in":"formData","name":"password_confirmation","required":true,"type":"string","description":"Password confirmation"}],"responses":{"201":{"description":"User created successfully","schema":{"$ref":"#/definitions/User"}},"422":{"description":"Validation error"}}}},"/user/profile":{"post":{"tags":["Profile"],"summary":"Create the user's profile","parameters":[{"in":"formData","name":"country","required":true,"type":"string"},{"in":"formData","name":"preferred_club_id","required":true,"type":"integer"},{"in":"formData","name":"wilaya","type":"string","description":"Required if country is DZ"},{"in":"formData","name":"team_name","type":"string","required":true}],"responses":{"201":{"description":"User's profile created successfully","schema":{"$ref":"#/definitions/User"}},"422":{"description":"Validation error"}}}},"/user/players":{"post":{"tags":["Profile"],"summary":"Buy players","parameters":[{"in":"formData","name":"players","type":"array","items":{"type":"integer"},"description":"Array of id of the players to be bought.<br>- Must be exactly 15 players;<br>- Max 4 players per club;<br>- Exactly 2 GK;<br>- Minimum 3 DF;<br>- Minimum 3 MF;<br>- Minimum 3 FW;","required":true}],"responses":{"201":{"description":"Players bought successfully","schema":{"type":"object","properties":{"players":{"type":"array","items":{"$ref":"#/definitions/Player"}}}}},"422":{"description":"Validation problem"}}}},"/user/players/transfers":{"get":{"tags":["Profile"],"responses":{"401":{"description":"Unauthenticated, redirect to login page"},"200":{"description":"OK","schema":{"type":"object","properties":{"user":{"$ref":"#/definitions/User"},"players":{"type":"array","items":{"$ref":"#/definitions/Player"}}}}}}},"post":{"tags":["Profile"],"summary":"Sell and buy players","parameters":[{"in":"formData","name":"in","type":"array","items":{"type":"integer"},"description":"Player ids to buy","required":true},{"in":"formData","name":"out","type":"array","items":{"type":"integer"},"description":"Player ids to sell","required":true}],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"players":{"type":"array","items":{"$ref":"#/definitions/Player"}}}}},"422":{"description":"Validation errors"}}},"delete":{"tags":["Profile"],"summary":"Cancel the transfers","responses":{"200":{"description":"OK"}}}},"/leagues/sponsored":{"get":{"tags":["Sponsored leagues"],"summary":"Get all available sponsored leagues","responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"leagues":{"type":"array","items":{"$ref":"#/definitions/SponsoredLeague"}}}}}}},"post":{"tags":["Sponsored leagues"],"summary":"Join a sponsored league","parameters":[{"in":"formData","name":"league_id","type":"integer","required":true}],"responses":{"200":{"description":"User joined the sponsored league successfully","schema":{"type":"array","items":{"$ref":"#/definitions/SponsoredLeague"}}},"404":{"description":"Sponsored league is not found"},"422":{"description":"User already joined a sponsored league"}}}},"/teams/create":{"get":{"tags":["Team"],"responses":{"401":{"description":"Unauthenticated, redirect to login page"},"200":{"description":"OK","schema":{"type":"object","properties":{"user":{"$ref":"#/definitions/User"},"players":{"type":"array","items":{"$ref":"#/definitions/Player"}}}}}}},"post":{"tags":["Team"],"summary":"Create a team for the user","parameters":[{"in":"formData","name":"starters","type":"array","items":{"type":"integer"},"description":"Array of id of the players that have been already bought and form a valid formation","required":true},{"in":"formData","name":"subs","type":"array","items":{"type":"integer"},"description":"Ordered array of substitutes","required":true}],"responses":{"201":{"description":"Team created successfully","schema":{"type":"object","properties":{"team":{"$ref":"#/definitions/Team"}}}},"422":{"description":"Validation errors"}}}},"/teams":{"get":{"tags":["Team"],"responses":{"401":{"description":"Unauthenticated, redirect to login page"},"200":{"description":"OK","schema":{"type":"object","properties":{"user":{"$ref":"#/definitions/User"},"teams":{"type":"array","items":{"$ref":"#/definitions/Team"}}}}}}}},"/teams/captain":{"post":{"tags":["Team"],"summary":"Select a captain for the team","parameters":[{"in":"formData","name":"player_id","type":"integer","required":true}],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"team":{"$ref":"#/definitions/Team"}}}},"422":{"description":"Validation errors"}}}},"/teams/substitute":{"post":{"tags":["Team"],"summary":"Substitute a player in user's team","parameters":[{"in":"formData","name":"out_player_id","type":"integer","required":true},{"in":"formData","name":"in_player_id","type":"integer","required":true}],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"team":{"$ref":"#/definitions/Team"}}}},"422":{"description":"Validation erros"}}}},"/leagues":{"get":{"tags":["Leagues"],"summary":"Get all user leagues","responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"user":{"$ref":"#/definitions/User"},"sponsored":{"allOf":[{"$ref":"#/definitions/SponsoredLeague"},{"type":"object","properties":{"rank_global":{"type":"integer"},"rank_round":{"type":"integer"}}}]},"leagues":{"type":"array","items":{"allOf":[{"$ref":"#/definitions/League"},{"type":"object","properties":{"rank_global":{"type":"integer"},"rank_round":{"type":"integer"}}}]}}}}}}},"post":{"tags":["Leagues"],"summary":"Create a private league","parameters":[{"in":"formData","name":"name","type":"string","required":true}],"responses":{"201":{"description":"Private league created successfully","schema":{"type":"object","properties":{"league":{"$ref":"#/definitions/League"}}}},"422":{"description":"Validation errors"}}}},"/leagues/join":{"post":{"tags":["Leagues"],"summary":"Join a private league","parameters":[{"in":"formData","name":"pin","type":"string","required":true}],"responses":{"201":{"description":"OK","schema":{"type":"object","properties":{"league":{"$ref":"#/definitions/League"}}}},"403":{"description":"You have been blocked from the league"},"404":{"description":"League not found"}}}},"/leagues/{league}":{"get":{"tags":["Leagues"],"summary":"Show league details","parameters":[{"in":"path","name":"league","type":"integer","required":true}],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"user":{"$ref":"#/definitions/User"},"league":{"$ref":"#/definitions/League"},"users":{"type":"array","items":{"$ref":"#/definitions/LeagueUser"}},"blocked":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"team_name":{"type":"string"}}}}}}},"403":{"description":"User doesn't have access to or is blocked the league"},"404":{"description":"League not found"}}},"put":{"tags":["Leagues"],"summary":"Update league name","parameters":[{"in":"path","name":"league","type":"integer","required":true}],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"league":{"$ref":"#/definitions/League"},"users":{"type":"array","items":{"$ref":"#/definitions/LeagueUser"}},"blocked":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"team_name":{"type":"string"}}}}}}},"403":{"description":"User is not owner of the league"},"404":{"description":"League not found"}}},"delete":{"tags":["Leagues"],"summary":"Delete the private league","parameters":[{"in":"path","name":"league","type":"integer","required":true}],"responses":{"200":{"description":"OK"},"403":{"description":"User is not owner of the league"},"404":{"description":"League not found"}}}},"/leagues/{league}/users/{user}":{"delete":{"tags":["Leagues"],"summary":"Delete users from league","parameters":[{"in":"path","name":"league","type":"integer","required":true},{"in":"path","name":"user","type":"integer","required":true}],"responses":{"200":{"description":"OK"},"404":{"description":"User not found in league"},"403":{"description":"Authenticated user is not league owner<br>Or is not selected user<br>Or selected user is the league owner (Owner can't delete himself)"}}}},"/leagues/{league}/invites":{"post":{"tags":["Leagues"],"summary":"Invite a user to join a private league","parameters":[{"in":"path","name":"league","type":"integer","required":true},{"in":"formData","name":"phones","type":"array","items":{"type":"string"},"required":true}],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"success":{"type":"array","items":{"type":"string"}},"error":{"type":"array","items":{"type":"string"}}}}}}}},"/leagues/{league}/blocked":{"post":{"tags":["Leagues"],"summary":"Block a league user","parameters":[{"in":"path","name":"league","type":"integer","required":true},{"in":"formData","name":"user_id","type":"integer","required":true}],"responses":{"200":{"description":"OK"},"404":{"description":"League not found"},"403":{"description":"User is not the owner of the league"},"422":{"description":"User doesn't exist is league, or already blocked"}}},"delete":{"tags":["Leagues"],"summary":"Unblock a league user","parameters":[{"in":"path","name":"league","type":"integer","required":true},{"in":"formData","name":"user_id","type":"integer","required":true}],"responses":{"200":{"description":"OK"},"404":{"description":"League not found"},"403":{"description":"User is not the owner of the league"},"422":{"description":"User is not blocked, or doesn't exist in league"}}}},"/matchcenter/fixtures":{"get":{"tags":["Matchcenter"],"responses":{"401":{"description":"Unauthenticated, redirect to login page"},"200":{"description":"OK","schema":{"type":"object","properties":{"fixtures":{"type":"array","items":{"$ref":"#/definitions/Fixture"}}}}}}}},"/matchcenter/fixtures/{fixture}":{"get":{"tags":["Matchcenter"],"parameters":[{"in":"path","name":"fixture","type":"integer","required":true}],"responses":{"401":{"description":"Unauthenticated, redirect to login page"},"200":{"description":"OK","schema":{"type":"object","properties":{"fixture":{"$ref":"#/definitions/Fixture"},"events":{"type":"array","items":{"type":"object","properties":{"minute":{"type":"integer"},"event":{"type":"string"},"player":{"$ref":"#/definitions/Player"}}}}}}}}}},"/matchcenter/clubs/{club}":{"get":{"tags":["Matchcenter"],"parameters":[{"in":"path","name":"club","type":"integer","required":true}],"responses":{"401":{"description":"Unauthenticated, redirect to login"},"200":{"description":"OK","schema":{"type":"object","properties":{"club":{"$ref":"#/definitions/ClubWithStats"},"fixtures":{"type":"array","items":{"$ref":"#/definitions/Fixture"}},"players":{"type":"array","items":{"$ref":"#/definitions/Player"}}}}}}}},"/matchcenter/players":{"get":{"tags":["Matchcenter"],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"players":{"type":"array","items":{"$ref":"#/definitions/Player"}}}}}}}},"/matchcenter/players/{player}":{"get":{"tags":["Matchcenter"],"parameters":[{"in":"path","name":"player","type":"integer","required":true}],"responses":{"200":{"description":"OK","schema":{"type":"object","properties":{"player":{"$ref":"#/definitions/Player"},"fixtures":{"type":"array","items":{"$ref":"#/definitions/FixtureWithStats"}}}}}}}}},"definitions":{"User":{"type":"object","properties":{"id":{"type":"integer","description":"The user ID."},"name":{"type":"string","description":"The user name."},"team_name":{"type":"string","description":"The user's team name"},"phone":{"type":"string","description":"The user phone number."},"facebook_provider_id":{"type":"string","description":"The user facebook provider id."},"budget":{"type":"number"},"transfers":{"type":"number"},"country":{"type":"string"},"wilaya":{"type":"string"},"preferred_club_id":{"type":"integer"},"rank_global_total":{"type":"integer"},"rank_global_round":{"type":"integer"},"rank_sponsored_total":{"type":"integer"},"rank_sponsored_round":{"type":"integer"},"points_total":{"type":"integer"},"points_round":{"type":"integer"}}},"Player":{"type":"object","properties":{"id":{"type":"integer","description":"Player ID"},"club":{"$ref":"#/definitions/Club"},"first_name":{"type":"string"},"last_name":{"type":"string"},"position":{"type":"string","description":"GK, DF, MF or FW"},"number":{"type":"integer"},"value":{"type":"number"},"injured_at":{"type":"string"},"suspended_until":{"type":"string"},"badges":{"type":"array","items":{"type":"string","description":"Hot, cold, ghost"}},"points":{"type":"integer"},"minutes_played":{"type":"integer"},"goals":{"type":"integer"},"assists":{"type":"integer"},"yellow_cards":{"type":"integer"},"red_cards":{"type":"integer"},"clean_sheets":{"type":"integer"},"popularity":{"type":"number"}}},"Fixture":{"type":"object","properties":{"matchday":{"type":"integer"},"home_club":{"$ref":"#/definitions/Club"},"away_club":{"$ref":"#/definitions/Club"},"home_score":{"type":"integer"},"away_score":{"type":"integer"},"scheduled_at":{"type":"string"},"postponed_to":{"type":"string"}}},"FixtureWithStats":{"allOf":[{"$ref":"#/definitions/Fixture"},{"type":"object","properties":{"points":{"type":"integer"},"minutes_played":{"type":"integer"},"goals":{"type":"integer"},"assists":{"type":"integer"},"yellow_cards":{"type":"integer"},"red_cards":{"type":"integer"},"clean_sheets":{"type":"integer"}}}]},"Club":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"eliminated_at":{"type":"string","description":"Date where the club is eliminated"},"fans_count":{"type":"integer"},"standing":{"type":"integer"}}},"ClubWithStats":{"allOf":[{"$ref":"#/definitions/Club"},{"type":"object","properties":{"match_played":{"type":"integer"},"match_won":{"type":"integer"},"match_lost":{"type":"integer"},"match_draw":{"type":"integer"},"goal_for":{"type":"integer"},"goal_against":{"type":"integer"}}}]},"SponsoredLeague":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"sponsor":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"users":{"type":"integer"}}},"League":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"pin":{"type":"string"},"owner":{"type":"object","properties":{"name":{"type":"string"},"team_name":{"type":"string","description":"The user's team name"}}},"users":{"type":"integer"}}},"Team":{"type":"object","properties":{"matchday":{"type":"integer"},"starters":{"type":"object","properties":{"players":{"type":"array","items":{"allOf":[{"$ref":"#/definitions/Player"},{"type":"object","properties":{"next_fixture":{"$ref":"#/definitions/Fixture"},"captain":{"type":"boolean"},"bench_out":{"type":"boolean"},"sold":{"type":"boolean"},"bought":{"type":"boolean"}}}]}}}},"subs":{"type":"array","items":{"allOf":[{"$ref":"#/definitions/Player"},{"type":"object","properties":{"order":{"type":"integer"},"next_fixture":{"$ref":"#/definitions/Fixture"},"bench_in":{"type":"boolean"},"sold":{"type":"boolean"},"bought":{"type":"boolean"}}}]}}}},"LeagueUser":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"team_name":{"type":"string"},"points_total":{"type":"integer"},"rank_total":{"type":"integer"},"points_round":{"type":"integer"},"rank_round":{"type":"integer"}}}}}