POST /summon/pal

Ponto final: POST /v1/pdapi/summon/pal Autenticação: Token do portador Permissão: REST.Summon.Pal

Objetivo

Gera um Pal em coordenadas fixas do mapa. A solicitação deve fornecer exatamente um entre PalID ou PalTemplate.

Solicitar corpo

Campo	Tipo	Obrigatório	Descrição
`PalID`	string	Um dos	ID da espécie Pal. Mutuamente exclusivo com `PalTemplate`.
`PalTemplate`	string	Um dos	Nome do arquivo de `Pals/Templates/`; usa o Pal e o nível do modelo.
`X`, `Y`, `Z`	número	Sim	Coordenadas do mapa.
`Level`	integer	Não	Nível para convocação `PalID` (padrão `1`). Ignorado para um modelo.
`Uncapturable`	bool	Não	Impede a captura (padrão `false`).
`DisableAI`	bool	Não	Desativa a IA normal (padrão `false`).
`DisableDamageMeter`	bool	Não	Desativa o rastreamento de danos (padrão `false`).
`DisableStatuses`	array	Não	Nomes de status a serem suprimidos.

Migração da vida máxima

Quando PalTemplate é usado, o valor HP do modelo se torna a vida máxima do Pal gerado. HealthMultiplier e HPMultiplier não são mais aceitos nas solicitações nem retornados nas respostas; remova-os das integrações REST existentes.

Esquema de resposta

200 response schema

Field	Type	Description
`Summoned`	object	Details of the spawned Pal.

Summoned contains Type ("Pal"), PalID, Level, Uncapturable, DisableAI, DamageMeter, and the requested X, Y, and Z. PalTemplate is also returned when a template was used.

Erros

Juntamente com as respostas padrão INVALID_TOKEN, MISSING_PERMISSION, INVALID_JSON, REQUEST_FAILED e REQUEST_TIMEOUT, esta rota pode retornar VALIDATION_FAILED, PAL_TEMPLATE_IMPORT_FAILED ou SUMMON_PAL_FAILED.

Exemplo

POST /v1/pdapi/summon/pal
Authorization: Bearer <token>
Content-Type: application/json

{
    "PalTemplate": "ArenaBoss.json",
    "X": 230,
    "Y": -486,
    "Z": 4097,
    "Uncapturable": true
}