Authenticate a player and receive a session ID

Looks up a player by email and creates a session. If no player exists with that email, one is auto-created with sensible defaults — making demos frictionless with any email address.

Magic email patterns (for testing edge cases):

• [e-mail] → 404 Player Not Found
• [e-mail] → 403 Account Suspended
• Any other email → auto-creates player if not found, returns session

POST /auth/player/login

Authenticate a player and receive a session ID

cURL

curl --request POST \
  --url https://mock-api.cevro.ai/v1/auth/player/login \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[e-mail]"
}
'

200

{
  "success": true,
  "session_id": "sess_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "player_id": "5832",
  "expires_at": "2023-11-07T05:31:56Z",
  "expires_in": 3600
}

Authorizations

Authorization · string · header · required

API Bearer token. For this demo, any non-empty string is accepted.

Body

application/json

email · string<email> · required

Example:

"[e-mail]"

Response

200

application/json

Successful authentication (player found or auto-created)

success · boolean

Example:

true

session_id · string

Example:

"sess_a1b2c3d4-e5f6-7890-abcd-ef1234567890"

player_id · string

Example:

"5832"

expires_at · string<date-time>

expires_in · integer

Seconds until expiry

Example:

3600