Description:

Please read the basics of JSON before trying to implement our API. Here's direct link to the resource. Please read how web requests work before continuing as well.

Initiates the authentication flow for your game. Send game UUID and device identifier, and receive authentication URL and ID. Required before any other API calls. Use this when starting your game.

Request Body:

• game_uuid: string (required) (to get your game_uuid, open ticket - https://discord.com/channels/823565989865979976/1000859527052279892/1007327394840969266 or DM @Deplumax )
• device_id: string (required) (in the pc settings)

Request Example:

{
  "game_uuid": "32bde2de-d225-448f-8c6a-263275d93ef2", 
  "device_id": "d63d00da-ed78-4eba-b531-0f556e64cd4e"
}

After the request:

• auth_id: string - Unique identifier of the authorization request
• auth_url: string - URL to authorize the request

Response Example:

{
  "auth_id": "d63d00da-ed78-4eba-b531-0f556e64cd4e",
  "auth_url": "<https://app.playmanity.net/auth/games/authorize/d63d00da-ed78-4eba-b531-0f556e64cd4e>"
}

Error Responses:

• 400 Bad Request:
  • error.code: MISSING_FIELDS
  • error.message: game_uuid and device_id are required
• 404 Not Found:
  • error.code: GAME_NOT_FOUND
  • error.message: Game not found