Personajes, licencias e inventario. Todas las rutas cuelgan de https://api.blixye.com/v1 y llevan la llave en la cabecera Authorization (ver Llaves y ámbitos). Esta página sale de la especificación OpenAPI de la API; lo que no esté aquí, la API no lo hace.
Personajes, licencias e inventario. Todas las rutas cuelgan de https://api.blixye.com/v1 y llevan la llave en la cabecera Authorization (ver Llaves y ámbitos). Esta página sale de la especificación OpenAPI de la API; lo que no esté aquí, la API no lo hace.
OJO
Personajes, licencias e inventario. Todas las rutas cuelgan de https://api.blixye.com/v1 y llevan la llave en la cabecera Authorization (ver Llaves y ámbitos). Esta página sale de la especificación OpenAPI de la API; lo que no esté aquí, la API no lo hace.
OJO
GET /characters: Lista de personajes (characters:read)
GET /characters/{id}: Un personaje (characters:read)
GET /characters/{id}/licenses: Licencias de un personaje (characters:read)
GET /characters/{id}/inventory: Inventario de un personaje (characters:read + inventory:read)
Lista de personajes
Lista de personajes
OJO
Lista de personajes
GET /characters. Personajes del servidor, con su DNI. Ámbito: characters:read.
GET /characters. Personajes del servidor, con su DNI. Ámbito: characters:read.
OJO
GET /characters. Personajes del servidor, con su DNI. Ámbito: characters:read.
Parámetros:
Parámetros:
OJO
Parámetros:
OJO
limit (consulta; entero, 1-100, por defecto 25, opcional): Tamaño de página (1-100).
cursor (consulta; texto, opcional): El meta.next_cursor de la página anterior.
order (consulta; texto, uno de: desc, asc, por defecto desc, opcional): desc = lo más nuevo primero.
member_id (consulta; texto, opcional): Solo los personajes de este miembro (usr_…).
name (consulta; texto, opcional): El nombre contiene este texto.
dni_number (consulta; texto, opcional): Número de DNI exacto.
curl "https://api.blixye.com/v1/characters?limit=25" \
-H "Authorization: Bearer bx_live_…"
curl "https://api.blixye.com/v1/characters?limit=25" \
-H "Authorization: Bearer bx_live_…"
OJO
curl "https://api.blixye.com/v1/characters?limit=25" \
-H "Authorization: Bearer bx_live_…"
Respuesta 200: Una página de personajes.
Respuesta 200: Una página de personajes.
OJO
Respuesta 200: Una página de personajes.
{
"data": [
{
"id": "chr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"member_id": "usr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "John Carter",
"dni_number": "48213377K",
"status": "approved",
"is_dead": false,
"is_ck": false,
"is_frozen": false,
"is_admin": false,
"driving_points": 12,
"dni": {
"first_name": "John",
"last_name": "Carter",
"nationality": "American",
"gender": "male",
"birthdate": "1990-05-14",
"blood_type": "O+",
"photo_url": "https://cdn.example.com/photo.png"
},
"created_at": "2026-09-27T18:04:05Z"
}
],
"meta": {
"next_cursor": "cur_3tq0vJ1c9Ydl2Hk7WqPzEw"
}
}
{
"data": [
{
"id": "chr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"member_id": "usr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "John Carter",
"dni_number": "48213377K",
"status": "approved",
"is_dead": false,
"is_ck": false,
"is_frozen": false,
"is_admin": false,
"driving_points": 12,
"dni": {
"first_name": "John",
"last_name": "Carter",
"nationality": "American",
"gender": "male",
"birthdate": "1990-05-14",
"blood_type": "O+",
"photo_url": "https://cdn.example.com/photo.png"
},
"created_at": "2026-09-27T18:04:05Z"
}
],
"meta": {
"next_cursor": "cur_3tq0vJ1c9Ydl2Hk7WqPzEw"
}
}
OJO
{
"data": [
{
"id": "chr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"member_id": "usr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "John Carter",
"dni_number": "48213377K",
"status": "approved",
"is_dead": false,
"is_ck": false,
"is_frozen": false,
"is_admin": false,
"driving_points": 12,
"dni": {
"first_name": "John",
"last_name": "Carter",
"nationality": "American",
"gender": "male",
"birthdate": "1990-05-14",
"blood_type": "O+",
"photo_url": "https://cdn.example.com/photo.png"
},
"created_at": "2026-09-27T18:04:05Z"
}
],
"meta": {
"next_cursor": "cur_3tq0vJ1c9Ydl2Hk7WqPzEw"
}
}
Errores (el formato está en Errores):
Errores (el formato está en Errores):
OJO
Errores (el formato está en Errores):
OJO
400: Petición mal formada (limit, cursor, JSON o Idempotency-Key inválidos, o la llave en la URL).
401: Llave ausente, inválida, revocada o caducada (códigos missing_api_key, invalid_api_key, api_key_revoked, api_key_expired).
403: A la llave le falta un ámbito (missing_scope), la IP no está permitida (ip_not_allowed), el plan del servidor no tiene API (plan_required) o un módulo del MDT está apagado (module_off).
404: No existe en este servidor. Un id de otro servidor es siempre un 404.
429: Demasiadas peticiones con esta llave (el límite es por llave y por minuto, según el plan). Demasiados fallos de autenticación desde una IP también dan 429.
Un personaje
Un personaje
OJO
Un personaje
GET /characters/{id}. Un personaje, con su DNI. Ámbito: characters:read.
GET /characters/{id}. Un personaje, con su DNI. Ámbito: characters:read.
OJO
GET /characters/{id}. Un personaje, con su DNI. Ámbito: characters:read.
Parámetros:
Parámetros:
OJO
Parámetros:
OJO
id (ruta; texto, obligatorio): Id del recurso.
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw" \
-H "Authorization: Bearer bx_live_…"
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw" \
-H "Authorization: Bearer bx_live_…"
OJO
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw" \
-H "Authorization: Bearer bx_live_…"
Respuesta 200: El personaje.
Respuesta 200: El personaje.
OJO
Respuesta 200: El personaje.
{
"data": {
"id": "chr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"member_id": "usr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "John Carter",
"dni_number": "48213377K",
"status": "approved",
"is_dead": false,
"is_ck": false,
"is_frozen": false,
"is_admin": false,
"driving_points": 12,
"dni": {
"first_name": "John",
"last_name": "Carter",
"nationality": "American",
"gender": "male",
"birthdate": "1990-05-14",
"blood_type": "O+",
"photo_url": "https://cdn.example.com/photo.png"
},
"created_at": "2026-09-27T18:04:05Z"
}
}
{
"data": {
"id": "chr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"member_id": "usr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "John Carter",
"dni_number": "48213377K",
"status": "approved",
"is_dead": false,
"is_ck": false,
"is_frozen": false,
"is_admin": false,
"driving_points": 12,
"dni": {
"first_name": "John",
"last_name": "Carter",
"nationality": "American",
"gender": "male",
"birthdate": "1990-05-14",
"blood_type": "O+",
"photo_url": "https://cdn.example.com/photo.png"
},
"created_at": "2026-09-27T18:04:05Z"
}
}
OJO
{
"data": {
"id": "chr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"member_id": "usr_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "John Carter",
"dni_number": "48213377K",
"status": "approved",
"is_dead": false,
"is_ck": false,
"is_frozen": false,
"is_admin": false,
"driving_points": 12,
"dni": {
"first_name": "John",
"last_name": "Carter",
"nationality": "American",
"gender": "male",
"birthdate": "1990-05-14",
"blood_type": "O+",
"photo_url": "https://cdn.example.com/photo.png"
},
"created_at": "2026-09-27T18:04:05Z"
}
}
Errores (el formato está en Errores):
Errores (el formato está en Errores):
OJO
Errores (el formato está en Errores):
OJO
400: Petición mal formada (limit, cursor, JSON o Idempotency-Key inválidos, o la llave en la URL).
401: Llave ausente, inválida, revocada o caducada (códigos missing_api_key, invalid_api_key, api_key_revoked, api_key_expired).
403: A la llave le falta un ámbito (missing_scope), la IP no está permitida (ip_not_allowed), el plan del servidor no tiene API (plan_required) o un módulo del MDT está apagado (module_off).
404: No existe en este servidor. Un id de otro servidor es siempre un 404.
429: Demasiadas peticiones con esta llave (el límite es por llave y por minuto, según el plan). Demasiados fallos de autenticación desde una IP también dan 429.
Licencias de un personaje
Licencias de un personaje
OJO
Licencias de un personaje
GET /characters/{id}/licenses. Las licencias del personaje (carné y las propias del servidor). Ámbito: characters:read.
GET /characters/{id}/licenses. Las licencias del personaje (carné y las propias del servidor). Ámbito: characters:read.
OJO
GET /characters/{id}/licenses. Las licencias del personaje (carné y las propias del servidor). Ámbito: characters:read.
Parámetros:
Parámetros:
OJO
Parámetros:
OJO
id (ruta; texto, obligatorio): Id del recurso.
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw/licenses" \
-H "Authorization: Bearer bx_live_…"
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw/licenses" \
-H "Authorization: Bearer bx_live_…"
OJO
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw/licenses" \
-H "Authorization: Bearer bx_live_…"
Respuesta 200: Licencias.
Respuesta 200: Licencias.
OJO
Respuesta 200: Licencias.
{
"data": [
{
"license_id": "lic_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "driving",
"label": "Driving licence",
"type": "driving",
"points_remaining": 12,
"max_points": 12,
"is_revoked": false,
"revoked_at": null,
"granted_at": "2026-09-27T18:04:05Z"
}
]
}
{
"data": [
{
"license_id": "lic_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "driving",
"label": "Driving licence",
"type": "driving",
"points_remaining": 12,
"max_points": 12,
"is_revoked": false,
"revoked_at": null,
"granted_at": "2026-09-27T18:04:05Z"
}
]
}
OJO
{
"data": [
{
"license_id": "lic_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "driving",
"label": "Driving licence",
"type": "driving",
"points_remaining": 12,
"max_points": 12,
"is_revoked": false,
"revoked_at": null,
"granted_at": "2026-09-27T18:04:05Z"
}
]
}
Errores (el formato está en Errores):
Errores (el formato está en Errores):
OJO
Errores (el formato está en Errores):
OJO
400: Petición mal formada (limit, cursor, JSON o Idempotency-Key inválidos, o la llave en la URL).
401: Llave ausente, inválida, revocada o caducada (códigos missing_api_key, invalid_api_key, api_key_revoked, api_key_expired).
403: A la llave le falta un ámbito (missing_scope), la IP no está permitida (ip_not_allowed), el plan del servidor no tiene API (plan_required) o un módulo del MDT está apagado (module_off).
404: No existe en este servidor. Un id de otro servidor es siempre un 404.
429: Demasiadas peticiones con esta llave (el límite es por llave y por minuto, según el plan). Demasiados fallos de autenticación desde una IP también dan 429.
Inventario de un personaje
Inventario de un personaje
OJO
Inventario de un personaje
GET /characters/{id}/inventory. Los objetos que lleva el personaje. Pide characters:read Y inventory:read. Ámbitos (todos): characters:read y inventory:read.
GET /characters/{id}/inventory. Los objetos que lleva el personaje. Pide characters:read Y inventory:read. Ámbitos (todos): characters:read y inventory:read.
OJO
GET /characters/{id}/inventory. Los objetos que lleva el personaje. Pide characters:read Y inventory:read. Ámbitos (todos): characters:read y inventory:read.
Parámetros:
Parámetros:
OJO
Parámetros:
OJO
id (ruta; texto, obligatorio): Id del recurso.
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw/inventory" \
-H "Authorization: Bearer bx_live_…"
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw/inventory" \
-H "Authorization: Bearer bx_live_…"
OJO
curl "https://api.blixye.com/v1/characters/chr_3tq0vJ1c9Ydl2Hk7WqPzEw/inventory" \
-H "Authorization: Bearer bx_live_…"
Respuesta 200: Inventario.
Respuesta 200: Inventario.
OJO
Respuesta 200: Inventario.
{
"data": [
{
"item_id": "itm_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "phone",
"label": "Phone",
"quantity": 1,
"equipped_quantity": 0,
"uses_remaining": null,
"image_url": "https://cdn.example.com/item.png"
}
]
}
{
"data": [
{
"item_id": "itm_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "phone",
"label": "Phone",
"quantity": 1,
"equipped_quantity": 0,
"uses_remaining": null,
"image_url": "https://cdn.example.com/item.png"
}
]
}
OJO
{
"data": [
{
"item_id": "itm_3tq0vJ1c9Ydl2Hk7WqPzEw",
"name": "phone",
"label": "Phone",
"quantity": 1,
"equipped_quantity": 0,
"uses_remaining": null,
"image_url": "https://cdn.example.com/item.png"
}
]
}
Errores (el formato está en Errores):
Errores (el formato está en Errores):
OJO
Errores (el formato está en Errores):
OJO
400: Petición mal formada (limit, cursor, JSON o Idempotency-Key inválidos, o la llave en la URL).
401: Llave ausente, inválida, revocada o caducada (códigos missing_api_key, invalid_api_key, api_key_revoked, api_key_expired).
403: A la llave le falta un ámbito (missing_scope), la IP no está permitida (ip_not_allowed), el plan del servidor no tiene API (plan_required) o un módulo del MDT está apagado (module_off).
404: No existe en este servidor. Un id de otro servidor es siempre un 404.
429: Demasiadas peticiones con esta llave (el límite es por llave y por minuto, según el plan). Demasiados fallos de autenticación desde una IP también dan 429.