This page contains documentation for the CpRedCharacterArmorController class, which handles character armors management for Cyberpunk Red.

Base Path: /api/v1/authorized
Package: dev.goral.rpgSystems.cpRed.characters.characterArmor

All requests to this controller require an XSRF token to be included in the headers.
Example:

headers: {
  "X-XSRF-TOKEN": "<csrfToken>"
}

• Id (Long): Unique identifier for the character armor. Required.
• baseArmorId (Long): Unique identifier for the armor type. Required.
• CharacterId (Long): Unique identifier for the character. Required.
• status (String): Status of the armor. Required. Possible values: EQUIPPED, STORED.
• place (String): Location of the armor. Required. Possible values: HEAD, BODY, SHIELD.
• currentArmorPoints (Integer): Current armor points of the character. Required.
• description (String): Description of the character armor. Required.

• message (String): Describes the result of the operation.
• error (Integer): HTTP status code.
• timestamp (String): Time the response was generated.
• characterArmor (Object): A single character armor object (if applicable).
• characterArmorList (Array): List of character armors (if applicable).

Method: GET
Path: /games/cpRed/characters/armors/{characterId}

{
  "characterArmors": [],
  "message": "Pancerze postaci pobrane pomyślnie",
  "error": 200,
  "timestamp": "..."
}

• 400 Bad Request: Invalid Character ID.
• 401 Unauthorized: User is not logged in.
• 404 Not Found: Character with the specified ID does not exist.

Method: POST
Path: /games/cpRed/characters/armors/create

{
  "baseArmorId": 1,
  "characterId": 1,
  "status": "EQUIPPED",
  "place": "BODY"
}

{
  "message": "Pancerz został dodany do postaci",
  "error": 200,
  "timestamp": "..."
}

• 400 Bad Request: User not authenticated.
• 401 Unauthorized: User not logged in.
• 404 Not Found: Invalid character armor data.

Method: PUT
Path: /games/cpRed/characters/armors/update/{characterArmorId}

{
  "status": "STORED",
  "currentArmorPoints": 2,
  "description": "Pancerz tak twardy jak..."
}

{
  "message": "Pancerz postaci został pomyślnie zmodyfikowany",
  "error": 200,
  "timestamp": "..."
}

• 400 Bad Request: Invalid character armor ID or data.
• 401 Unauthorized: User not logged in.
• 404 Not Found: Character armor with the specified ID does not exist.

Method: DELETE Path: /games/cpRed/characters/armors/delete/{characterArmorId}

{
  "message": "Pancerz postaci został pomyślnie usunięty",
  "error": 200,
  "timestamp": "..."
}

• 400 Bad Request: Invalid character armor ID.
• 401 Unauthorized: User not logged in.
• 404 Not Found: Character armor with the specified ID does not exist.

Method: GET
Path: /admin/games/cpRed/characters/armors/all

{
  "characterArmors": [],
  "message": "Wszystkie pancerze postaci pobrane pomyślnie",
  "error": 200,
  "timestamp": "..."
}

• 401 Unauthorized: User is not logged in.
• 403 Forbidden: User is not an admin.

• Missing XSRF Token: Ensure the X-XSRF-TOKEN header is included in every request.
• Invalid Fields: Double-check the request body for missing or invalid fields.
• Permission Issues: Verify that the user has the necessary permissions for the requested operation.