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" } }

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"
}