{"message":"PhunParty Backend API - Welcome!","version":"1.0.0","description":"A fun party trivia game backend API","documentation":"/docs","available_endpoints":[{"entity":"Game Management","base_path":"/game","description":"Manage game sessions and game types","endpoints":[{"method":"POST","endpoint":"/game/","description":"Create a new game type","example":"POST http://localhost:8000/game/"},{"method":"POST","endpoint":"/game/create/session","description":"Create a new game session","example":"POST http://localhost:8000/game/create/session"},{"method":"GET","endpoint":"/game/{game_code}","description":"Get game details by game code","example":"GET http://localhost:8000/game/TRIVIA001"},{"method":"GET","endpoint":"/game/","description":"Get all available games","example":"GET http://localhost:8000/game/"},{"method":"POST","endpoint":"/game/join","description":"Join an existing game session","example":"POST http://localhost:8000/game/join"},{"method":"GET","endpoint":"/game/history/{player_id}","description":"Get game history for a player","example":"GET http://localhost:8000/game/history/PLAYER123"},{"method":"POST","endpoint":"/game/join-queue","description":"Join the game queue when multiple players are joining at once","example":"POST http://localhost:8000/game/join-queue"},{"method":"GET","endpoint":"/game/queue-status/{queue_id}","description":"Get the status of a game queue","example":"GET http://localhost:8000/game/queue-status/QUEUE123"},{"method":"GET","endpoint":"/game/queue-stats","description":"Get statistics about current game queues","example":"GET http://localhost:8000/game/queue-stats"},{"method":"GET","endpoint":"/game/sessions/public","description":"Get all public game sessions","example":"GET http://localhost:8000/game/sessions/public"},{"method":"GET","endpoint":"/game/sessions/private/{player_id}","description":"Get details about a specific game session for a player","example":"GET http://localhost:8000/game/sessions/private/PLAYER123"},{"method":"POST","endpoint":"/game/end-game/{session_code}","description":"End a game session","example":"POST http://localhost:8000/game/end-game/SESSION123"},{"method":"GET","endpoint":"/game/sessions/{session_code}/details","description":"Get details about a specific game session","example":"GET http://localhost:8000/game/sessions/SESSION123/details"},{"method":"GET","endpoint":"/game/sessions/{session_code}/join-info","description":"Get join information for a specific game session","example":"GET http://localhost:8000/game/sessions/SESSION123/join-info"}]},{"entity":"Player Management","base_path":"/players","description":"Manage players in the game","endpoints":[{"method":"POST","endpoint":"/players/create","description":"Create a new player","example":"POST http://localhost:8000/players/create"},{"method":"GET","endpoint":"/players/{player_id}","description":"Get player details by ID","example":"GET http://localhost:8000/players/PLAYER123"},{"method":"GET","endpoint":"/players/","description":"Get all players","example":"GET http://localhost:8000/players/"},{"method":"DELETE","endpoint":"/players/{player_id}","description":"Delete a player","example":"DELETE http://localhost:8000/players/PLAYER123"},{"method":"PUT","endpoint":"/players/{player_id}","description":"Update player profile","example":"PUT http://localhost:8000/players/PLAYER123"}]},{"entity":"Questions Management","base_path":"/questions","description":"Manage trivia questions","endpoints":[{"method":"GET","endpoint":"/questions/{question_id}","description":"Get question by ID","example":"GET http://localhost:8000/questions/Q001"},{"method":"POST","endpoint":"/questions/add","description":"Add a new question","example":"POST http://localhost:8000/questions/add"}]},{"entity":"Scores Management","base_path":"/scores","description":"Manage player scores and game results","endpoints":[{"method":"GET","endpoint":"/scores/{session_code}","description":"Get scores for a game session","example":"GET http://localhost:8000/scores/3ERH4I225"}]},{"entity":"Game Logic & Progression","base_path":"/game-logic","description":"Handle automatic game progression and player responses","endpoints":[{"method":"POST","endpoint":"/game-logic/submit-answer","description":"Submit a player's answer (auto-advances game when all players answer)","example":"POST http://localhost:8000/game-logic/submit-answer"},{"method":"GET","endpoint":"/game-logic/status/{session_code}","description":"Get current game status and progression","example":"GET http://localhost:8000/game-logic/status/SESSION123"},{"method":"GET","endpoint":"/game-logic/current-question/{session_code}","description":"Get the current question for a session","example":"GET http://localhost:8000/game-logic/current-question/SESSION123"},{"method":"PUT","endpoint":"/game-logic/start-game/{session_code}","description":"Update the game's started status","example":"PUT http://localhost:8000/game-logic/start-game/{session_code"}]},{"entity":"Authentication","base_path":"/auth","description":"User authentication endpoints","endpoints":[{"method":"POST","endpoint":"/auth/login","description":"Login a player","example":"POST http://localhost:8000/auth/login"}]},{"entity":"Password Reset","base_path":"/password-reset","description":"Password reset via OTP","endpoints":[{"method":"PUT","endpoint":"/password-reset/update","description":"Update password using verified OTP","example":"PUT http://localhost:8000/password-reset/update"}]}]}