Actualizar detalles del personaje

curl --request PATCH \
  --url https://app.npcbuilder.com/api/context/characters/{game_id}/{world_id}/{character_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "age": "adult",
  "description": "Un valiente guerrero con un pasado misterioso.",
  "gender": "Male",
  "model": "standard",
  "filters": {
    "active": true,
    "violence": true,
    "sexual": false,
    "drugs": false
  },
  "items": [
    {
      "type": "trade",
      "itemName": "Sword",
      "unit": "Pieza",
      "value": "100",
      "description": "Una espada afilada."
    }
  ],
  "events": [
    {
      "type": "item",
      "eventName": "Attack",
      "description": "Acto de violencia contra otra persona."
    }
  ],
  "name": "Aragorn",
  "quests": [
    {
      "description": "Recupera el artefacto perdido.",
      "objective": "Encontrar y devolver el artefacto.",
      "reward": "500 monedas de oro"
    }
  ],
  "role": "protagonist",
  "tone": "mysterious",
  "traits": [
    "brave"
  ],
  "personality_theory": "basicTraits",
  "personality_dimensions": {
    "machiavellianism": 4,
    "narcissism": 2,
    "psychopathy": 1
  },
  "speech_pattern": {
    "vocabulary_level": "sophisticated",
    "sentence_length": "terse",
    "verbal_quirks": "Siempre dice 'querido amigo'"
  }
}
EOF

{
  "message": "Personaje: character789 ha sido actualizado con el siguiente contexto.",
  "character_id": "character789",
  "character_context": {
    "age": "adult",
    "description": "Un valiente guerrero con un pasado misterioso.",
    "gender": "Male",
    "items": [
      {
        "itemName": "Sword",
        "unit": "Pieza",
        "value": "100"
      }
    ],
    "name": "Aragorn",
    "quests": [
      {
        "description": "Recupera el artefacto perdido.",
        "objective": "Encontrar y devolver el artefacto.",
        "reward": "500 monedas de oro"
      }
    ],
    "role": "protagonist",
    "tone": "mysterious",
    "traits": [
      "brave"
    ],
    "personality_theory": "basicTraits",
    "personality_dimensions": {}
  }
}

PATCH

context

characters

{game_id}

{world_id}

{character_id}

Actualizar detalles del personaje

curl --request PATCH \
  --url https://app.npcbuilder.com/api/context/characters/{game_id}/{world_id}/{character_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "age": "adult",
  "description": "Un valiente guerrero con un pasado misterioso.",
  "gender": "Male",
  "model": "standard",
  "filters": {
    "active": true,
    "violence": true,
    "sexual": false,
    "drugs": false
  },
  "items": [
    {
      "type": "trade",
      "itemName": "Sword",
      "unit": "Pieza",
      "value": "100",
      "description": "Una espada afilada."
    }
  ],
  "events": [
    {
      "type": "item",
      "eventName": "Attack",
      "description": "Acto de violencia contra otra persona."
    }
  ],
  "name": "Aragorn",
  "quests": [
    {
      "description": "Recupera el artefacto perdido.",
      "objective": "Encontrar y devolver el artefacto.",
      "reward": "500 monedas de oro"
    }
  ],
  "role": "protagonist",
  "tone": "mysterious",
  "traits": [
    "brave"
  ],
  "personality_theory": "basicTraits",
  "personality_dimensions": {
    "machiavellianism": 4,
    "narcissism": 2,
    "psychopathy": 1
  },
  "speech_pattern": {
    "vocabulary_level": "sophisticated",
    "sentence_length": "terse",
    "verbal_quirks": "Siempre dice 'querido amigo'"
  }
}
EOF

{
  "message": "Personaje: character789 ha sido actualizado con el siguiente contexto.",
  "character_id": "character789",
  "character_context": {
    "age": "adult",
    "description": "Un valiente guerrero con un pasado misterioso.",
    "gender": "Male",
    "items": [
      {
        "itemName": "Sword",
        "unit": "Pieza",
        "value": "100"
      }
    ],
    "name": "Aragorn",
    "quests": [
      {
        "description": "Recupera el artefacto perdido.",
        "objective": "Encontrar y devolver el artefacto.",
        "reward": "500 monedas de oro"
      }
    ],
    "role": "protagonist",
    "tone": "mysterious",
    "traits": [
      "brave"
    ],
    "personality_theory": "basicTraits",
    "personality_dimensions": {}
  }
}

Autorizaciones

Authorization

string

header

requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

game_id

string

requerido

El identificador único del juego.

Ejemplo:

"game123"

world_id

string

requerido

El identificador único del mundo.

Ejemplo:

"world456"

character_id

string

requerido

El identificador único del personaje.

Ejemplo:

"character789"

Parámetros de consulta

session_id

string

(Opcional) El ID de sesión del jugador.

Ejemplo:

"60Z5aZjIuFlyYbjbZZKe"

Cuerpo

application/json

Los campos de datos del personaje a actualizar.

age

enum<string>

La categoría de edad del personaje.

Opciones disponibles:

infant,

child,

teenager,

youngAdult,

adult,

middleAged,

elderly

Ejemplo:

"adult"

description

string

Una breve descripción del personaje.

Ejemplo:

"Un valiente guerrero con un pasado misterioso."

gender

string

El género del personaje.

Ejemplo:

"Male"

model

enum<string>

El modelo de IA usado para las interacciones del personaje. Los modelos premium solo están disponibles para algunas suscripciones.

Opciones disponibles:

standard,

premium

Ejemplo:

"standard"

filters

object

Filtros de contenido estructurados aplicados a las respuestas del personaje. Indica los valores que deseas actualizar al ajustar la configuración de moderación.

Show child attributes

Ejemplo:

{
  "active": true,
  "violence": true,
  "sexual": false,
  "drugs": false
}

items

object[]

Lista actualizada de objetos del personaje.

Esquema para objetos de tipo "trade"

Option 1
Option 2

Show child attributes

events

object[]

Lista de eventos relacionados con el personaje.

Esquema para eventos de tipo "action"

Option 1
Option 2

Show child attributes

name

string

El nombre visible del personaje.

Ejemplo:

"Aragorn"

quests

object[]

Una lista de misiones asociadas al personaje.

Show child attributes

role

enum<string>

El rol que desempeña el personaje en el juego.

Opciones disponibles:

noRole,

protagonist,

antagonist,

secondaryCharacter,

tertiaryCharacter,

mentor,

enemy,

villain,

rival,

shopkeeper,

healer,

questGiver,

innkeeper,

guard,

familyMember,

loveInterest,

scientist,

politician,

criminal,

explorer,

wizard,

ghost,

animalCompanion,

artificialIntelligence

Ejemplo:

"protagonist"

tone

enum<string>

El estilo o estado de ánimo del diálogo del personaje.

Opciones disponibles:

formal,

casual,

sarcastic,

mysterious,

emotive

Ejemplo:

"mysterious"

traits

string[]

Lista legacy/de rasgos básicos. Si se envía sin personality_theory, la API guarda el personaje como basicTraits.

personality_theory

enum<string>

predeterminado:basicTraits

Marco de personalidad utilizado por interacciones.

Opciones disponibles:

basicTraits,

bigFive,

darkTriad,

dndAlignment,

mbti,

enneagram

Ejemplo:

"basicTraits"

personality_dimensions

object

Valores de dimensiones para el personality_theory seleccionado. basicTraits usa traits y un objeto vacío.

Show child attributes

Ejemplo:

{
  "machiavellianism": 4,
  "narcissism": 2,
  "psychopathy": 1
}

speech_pattern

object

Controles opcionales del estilo de habla consumidos por interacciones.

Show child attributes

Respuesta

Personaje actualizado correctamente.

message

string

Mensaje de confirmación tras actualizar el personaje.

Ejemplo:

"Personaje: character789 ha sido actualizado con el siguiente contexto."

character_id

string

UID del personaje.

Ejemplo:

"character789"

character_context

object

Datos del contexto del personaje actualizados.

Ejemplo:

{
  "age": "adult",
  "description": "Un valiente guerrero con un pasado misterioso.",
  "gender": "Male",
  "items": [
    {
      "itemName": "Sword",
      "unit": "Pieza",
      "value": "100"
    }
  ],
  "name": "Aragorn",
  "quests": [
    {
      "description": "Recupera el artefacto perdido.",
      "objective": "Encontrar y devolver el artefacto.",
      "reward": "500 monedas de oro"
    }
  ],
  "role": "protagonist",
  "tone": "mysterious",
  "traits": ["brave"],
  "personality_theory": "basicTraits",
  "personality_dimensions": {}
}

Eliminar un personaje Crear un nuevo mundo

Documentation Index

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Cuerpo

Respuesta