GET /version
Ponto final: GET /v1/pdapi/version
Autenticação: Token do portador
Permissão: REST.Version.Read
Objetivo
Use esse endpoint como verificação de integridade e versão de ferramentas, painéis e scripts.
Parâmetros de caminho
Nenhum.
Parâmetros de consulta
Nenhum.
Solicitar corpo
Nenhum corpo de solicitação.
Esquema de resposta
200 response schema
| Field | Type | Description |
|---|---|---|
Version |
object | PalDefender version details. |
Version object schema:
| Field | Type | Description |
|---|---|---|
Major |
integer | Major version number. |
Minor |
integer | Minor version number. |
Patch |
integer | Patch version number. |
Build |
integer | Build number. |
Version |
string | Short version string. |
VersionLong |
string | Long version string. |
Beta |
boolean | Whether this build is marked as beta. |
Respostas de erro
Os corpos de erro usam esta forma:
| HTTP | Código de erro | Quando isso acontece |
|---|---|---|
401 |
INVALID_TOKEN |
O cabeçalho Authorization está ausente, malformado ou não corresponde a um token de portador configurado. |
403 |
MISSING_PERMISSION |
O token é válido, mas não inclui essa permissão de endpoint. |
Exemplos
Verificação de integridade e versão
Cenários
- Use-o após configurar o token REST API para confirmar o funcionamento da autenticação.
- Use-o antes de chamar endpoints se sua ferramenta precisar de uma versão mínima de PalDefender.
- Use-o para monitoramento, pois é a menor solicitação somente leitura.