Introduction

Welcome to the WuwaAPI documentation. This API provides data for characters, weapons, and more from Wuthering Waves.

Base URL: https://wuwa-api.projektcode.com

All endpoints (except health check) are prefixed with /v1.

Rate Limits & Caching

Rate limits are enforced per IP address (defaults shown below).

Self-hosting: configure via RATE_LIMIT_LIST_MAX, RATE_LIMIT_DETAIL_MAX, RATE_LIMIT_IMAGE_MAX, and RATE_LIMIT_WINDOW.

Responses include ETag headers. Please respect Cache-Control directives:

GET /healthz

Health check endpoint. Returns 200 OK if service is up.

GET /v1/meta

Get server metadata and version info.

GET /v1/characters

List all characters with pagination and filtering.

GET /v1/characters/:id

Get detailed info for a single character.

:id can be the character name (case-insensitive, e.g. jinhsi).

{
  "name": "Jinhsi",
  "rarity": 5,
  "element": "Spectro",
  "weaponType": "Broadblade",
  "stats": { ... },
  "images": { ... }
}

GET /v1/characters/:id/images

List available image files for a character.

curl "https://wuwa-api.projektcode.com/v1/characters/jinhsi/images"

The response includes URLs like /v1/characters/jinhsi/images/icon.webp.

GET /v1/characters/:id/images/:file

Serve a raw image file.

:file must match one of the filenames returned by /v1/characters/:id/images (including extension, e.g. icon.webp).

These responses are immutable and cached for 1 year.

GET /v1/images/characters/:id/:asset.webp

Static image URLs referenced by the JSON payloads (e.g. icon.webp, card.webp, splash.webp, attribute.webp).

curl -I "https://wuwa-api.projektcode.com/v1/images/characters/jinhsi/icon.webp"

GET /v1/weapons

List all weapons.

Param	Description
search	Filter by name
type	Filter by weapon type (e.g. Sword)
rarity	Filter by star rating
limit	Max results
offset	Pagination offset

GET /v1/weapons/:id

Get detailed info for a single weapon.