Saltar al contenido principal
POST
/
context
/
location
/
{game_id}
/
{world_id}
/
{region_id}
Crear una nueva localización
curl --request POST \
  --url https://app.npcbuilder.com/api/context/location/{game_id}/{world_id}/{region_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lore": "Una bulliciosa ciudad mercantil.",
  "name": "Rivertown",
  "role": "Centro de comercio"
}
'
{
  "message": "Localización: location789 ha sido creada con el siguiente contexto.",
  "location_id": "location789",
  "location_context": {
    "lore": "Una bulliciosa ciudad mercantil.",
    "name": "Rivertown",
    "role": "Centro de comercio"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.npcbuilder.com/llms.txt

Use this file to discover all available pages before exploring further.

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"

​
region_id
string
requerido

El identificador único de la región donde se creará la localización.

Ejemplo:

"region789"

Parámetros de consulta

​
session_id
string

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

Ejemplo:

"60Z5aZjIuFlyYbjbZZKe"

Cuerpo

application/json

Los datos necesarios de la localización para crearla.

​
lore
string

Trasfondo o descripción de la localización.

Ejemplo:

"Una bulliciosa ciudad mercantil."

​
name
string

El nombre de la localización.

Ejemplo:

"Rivertown"

​
role
string

El rol o función de la localización (p. ej., centro de comercio, zona residencial).

Ejemplo:

"Centro de comercio"

Respuesta

Localización creada correctamente.

​
message
string

Mensaje de confirmación tras crear la localización.

Ejemplo:

"Localización: location789 ha sido creada con el siguiente contexto."

​
location_id
string

UID de la localización.

Ejemplo:

"location789"

​
location_context
object

Detalles del contexto de la localización creada.

Ejemplo:
{
  "lore": "Una bulliciosa ciudad mercantil.",
  "name": "Rivertown",
  "role": "Centro de comercio"
}