Authentication

​

Base URL

​

Guest Authentication

​

Guest Login

{
  "publicKey": "your-project-public-key",
  "playerId": "optional-custom-player-id"
}

{
  "statusCode": 200,
  "data": {
    "token": "jwt-token-here",
    "playerId": "generated-or-custom-player-id",
    "sequentialId": 12345
  }
}

• publicKey (required): Your project’s public key for identification
• playerId (optional): Custom player ID. If not provided, one will be generated

​

Steam Authentication

​

Steam Login

{
  "publicKey": "your-project-public-key",
  "steamAuthTicket": "steam-authentication-ticket"
}

{
  "statusCode": 200,
  "data": {
    "token": "jwt-token-here",
    "playerId": "player-id",
    "sequentialId": 12345,
    "steamId": "steam-64-id"
  }
}

• publicKey (required): Your project’s public key for identification
• steamAuthTicket (required): Steam authentication ticket from the Steam API

​

Using the Authentication Token

Authorization: Bearer <your-jwt-token>

​

Error Responses

​

Invalid Project Key

{
  "statusCode": 404,
  "error": {
    "message": "Project not found"
  }
}

​

Invalid Steam Ticket

{
  "statusCode": 400,
  "error": {
    "message": "Invalid Steam authentication ticket"
  }
}

​

General Authentication Errors

{
  "statusCode": 400,
  "error": {
    "message": "Authentication failed"
  }
}

​

Implementation Notes

1. Project Public Key: You must obtain a public key from your CrateBytes project dashboard
2. Steam Integration: For Steam authentication, you’ll need to integrate with Steam’s authentication system
3. Token Expiration: JWT tokens expire after 24 hours
4. Player Identification: Each player gets a unique sequentialId for internal tracking