---
title: "POST | Criar dispositivo"
slug: "api-post-create-device"
updated: 2026-03-04T12:05:16Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-post-create-device"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.
# POST | Criar dispositivo
Crie um dispositivo no **PAM Core**.
## Pré-requisitos
- Autorização com permissão de **acesso** e de **leitura e escrita** ao **PAM Core** concedidas pelo administrador no **A2A**.
Saiba mais em [Como gerenciar autorizações no A2A](/v4-2/docs/pt/how-to-manage-authorizations-in-a2a).
## Requisição
` POST` `/api/pam/device`
## Parâmetros de requisição
Envie os parâmetros abaixo no **body** da requisição.
- ip - string - obrigatório - Endereço IP do dispositivo.
- hostname - string - obrigatório - Nome do host do dispositivo.
Info
Se o `hostname` fornecido corresponder ao de um dispositivo previamente criado, esta requisição atualizará o dispositivo existente. Caso contrário, ela criará um novo dispositivo e o associará a este `hostname`.
- model - string - obrigatório - Modelo do dispositivo.
**Nota**: um novo modelo é criado se o valor for único.
- type - string - obrigatório - Tipo de dispositivo.
**Nota**: um novo tipo é criado se o valor for único.
- vendor - string - obrigatório - Fabricante do dispositivo.
**Nota**: um novo fabricante é criado se o valor for único.
- site - string - obrigatório - Localização do dispositivo.
**Nota**: um novo site é criado se o valor for único.
- device_domain - string - Nome ou abreviação do domínio.
**Nota**: apenas domínios previamente registrados são aceitos. **Exemplo**: `api,app`
Atenção
Ao listar mais de um `device_domain`, adicione vírgulas sem espaço entre eles, conforme o exemplo a seguir: `testlab.com,demo.lab.com`
- device_tags - string - Palavras-chave associadas ao dispositivo.
- connectivities - string - Conectividade do dispositivo.
- session_remote_config - string - Expressão do login.
### Exemplo de requisição
` POST` `{{url}}/api/pam/device`
```
{
"ip": "10.66.33.120",
"hostname": "API device test",
"model": "Gmail",
"type": "Desktop",
"vendor": "Linux",
"site": "AWS"
}
```
## Resposta
```
HTTP/1.1 200 OK
```
```
{
"code": 200,
"response": {
"status": 200,
"message": "Device [device_id]",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Device [device_id]",
"erro": false,
"cod_erro": 0
},
"device": {
"id": "17",
"hostname": "API device test",
"ip": "10.66.33.120",
"model": "Gmail",
"type": "Desktop",
"vendor": "Linux",
"site": "AWS",
"device_domain": "",
"connectivities": "",
"session_remote_config": "",
"device_tags": ""
}
}
```
## Erros
****400 - Bad Request**.**
---
**Mensagem: "1004: The device's hostname was not informed"**
**Possível causa**: o parâmetro obrigatório `hostname` do dispositivo não foi informado.
**Solução**: informe o `hostname` do dispositivo e envie a requisição novamente.
---
**Mensagem: "1005: The device's IP was not informed"**
**Possível causa**: o parâmetro obrigatório `ip` do dispositivo não foi informado.
**Solução**: informe o `ip` do dispositivo e envie a requisição novamente.
---
**Mensagem: "1019: The device's site was not informed"**
**Possível causa**: o parâmetro obrigatório `site` do dispositivo não foi informado.
**Solução**: informe um valor para o parâmetro `site` e envie a requisição novamente.
---
**Mensagem: "1020: The device's model was not informed"**
**Possível causa**: o parâmetro obrigatório `model` do dispositivo não foi informado.
**Solução**: informe um valor para o parâmetro `model` e envie a requisição novamente.
---
**Mensagem: "1021: The device's vendor was not informed"**
**Possível causa**: o parâmetro obrigatório `vendor` do dispositivo não foi informado
**Solução**: informe um valor para o parâmetro `vendor` e envie a requisição novamente.
---
**Mensagem: "1022: The device's type was not informed"**
**Possível causa**: o parâmetro obrigatório `type` do dispositivo não foi informado.
**Solução**: informe um valor para o parâmetro `type` e envie a requisição novamente.
---
**Mensagem: "1029: It is not possible to enter a domain that has not been previously registered"**
**Possível causa**: não é possível enviar um domínio que não tenha sido registrado.
**Solução**: informe um valor válido para o parâmetro `device_domain` e envie a requisição novamente.
---
**Mensagem: "1039: Without PAM Configuration Access permission"** **Possível causa**: sua autorização não possui permissão de alteração de dispositivo.
**Solução**: solicite ao administrador que revise sua permissão de **leitura e escrita** aos recursos do **PAM Core** no **A2A**.
---
****404 - Not Found**.**
---
**Mensagem: "Resource sub not found"**
**Possível causa**: a URL ou o recurso solicitado não está correto.
**Solução**: verifique a URL e garanta que todos os parâmetros estão corretos.
---
****500 - Internal Server Error**.**
---
**Mensagem: "Unexpected error."**
**Possível causa**: o erro está no servidor Segura®.
**Solução**: contate o time de suporte para mais informações.
---
**Mensagem: "You are not authorized to access this resource."**
**Possível causa**: você não possui autorização para acessar esse recurso.
**Solução**: solicite ao administrador que revise sua permissão de acesso aos recursos do **PAM Core** no **A2A**.
---
****Client authentication failed**.**
---
**Mensagem: "Client authentication failed."**
**Possível causa**: falha na autenticação da sua aplicação com o servidor Segura®.
**Solução**: verifique os parâmetros de autenticação como `Access Token URL`, `Client ID` e `Client secret` e solicite um novo token de acesso.
****Invalid signature**.**
---
**Mensagem: "Invalid signature"**
**Possível causa**: falha no reconhecimento da URL da aplicação cliente.
**Solução**: verifique a URL da aplicação cliente e envie a requisição novamente.
---
****No route matched with those values**.**
---
**Mensagem: "No route matched with those values."**
**Possível causa**: ausência do header de autorização na requisição de API.
**Solução**: solicite um novo token de acesso.
---
****Request timed out**.**
---
**Mensagem: "Request timed out."**
**Possível causa**: o tempo da requisição se esgotou.
**Solução**: verifique a conectividade entre a origem da requisição e o servidor Segura®.