RemotePC Enterprise API aceita solicitações e devolve respostas no formato 'JSON'. O mecanismo de autenticação de chaves API é usado junto com a lista branca de IP para autenticar as APIs. Para todas as APIs, a API Key deve ser adicionada no cabeçalho da autorização.
Você pode enviar as solicitações API usando a chave API gerada para sua conta no console web.
Para obter a chave da API,
- Acesse a sua conta RemotePC Enterprise.
- Vá até a guia Minha Conta e clique em Chaves API.
- Clique em View, digite a senha da conta e clique em View.
- A chave API será exibida. Clique em Copy Key para copiar para a área de transferência.
Para mudar a chave API, clique em Change. Digite a senha da conta e clique em View para visualizar a nova chave API.
Nota: Somente o Admin (proprietário da conta) pode gerar a chave API.
1. Convidar usuário
URL: https://web1.remotepc.com/rpcnew/api/msp/user/invite
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
string[]: email - Obrigatório
int: status_2FA - Opcional (os valores permitidos são 0 e 1; 1 - Status ON & 0 - Status OFF)
Resposta Http
200 (Sucesso)
500 (Erro do Servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
Solicitar amostra 1
{
"email": [
"[email protected]"
]
}
Solicitar amostra 2
{
"email": [
"[email protected]"
],
"status_2FA":1
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": {
"invalid_list": [
"[email protected]"
]
"invited_list": [
"[email protected]"
]
}
}
Amostra de erro de resposta
{
"status": "INTERNAL_SERVER_ERROR",
"code": 500,
"errorsCount": 1,
"errors": [
{
"description": "INTERNAL_SERVER_ERROR"
}
]
}
A descrição pode incluir
FALHADO
INTERNO_SERVIDOR_ERVIDOR_ERRO
Usuário inválido
Permissão de usuário inválida
Plano de usuário inválido
Status de dois fatores inválidos
2. Criar usuário
URL: https://web1.remotepc.com/rpcnew/api/msp/user/create
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
string: primeiro nome - Obrigatório
cordão: sobrenome - Obrigatório
string: nome de usuário - Obrigatório
string: senha - Obrigatório
int: status_2FA - Opcional (os valores permitidos são 0 e 1; 1 - Status ON & 0 - Status OFF)
Resposta HTTP
200 (Sucesso)
500 (Erro do Servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
Solicitar amostra 1
{
"firstname": "firstname",
"lastname": "lastname",
"username": "[email protected]",
"password": "password"
}
Solicitar amostra 2
{
"firstname": "firstname",
"lastname": "lastname",
"username": "[email protected]",
"password": "password",
"status_2FA":1
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": "SUCCESS"
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Email is already in use or already invited."
}
]
}
A descrição pode incluir
FAILED
INTERNAL_SERVER_ERROR
Invalid user
Invalid user permission
Invalid user plan
First name cannot be blank
First name can contain a-z, A-Z and space
Last name cannot be blank
Last name can contain a-z, A-Z and space
Username/Email cannot be blank
Enter a valid Username/Email
Password cannot be blank
Password can contain A-Z, a-z, 0-9 and ~`[email protected]#$%^&*()-_+={}|[];\'\"<>,.?/
Password should be between 6 - 20 characters
Email is already in use or already invited.
Email in use with other Admin
Invalid two factor status
3. Excluir usuário
URL: https://web1.remotepc.com/rpcnew/api/msp/user/delete
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
string[]: sub_ids - Obrigatório
string[]: invited_ids - Obrigatório
sub_id: IDs de e-mail de usuários ativos,
convidados_ids: IDs de e-mail dos usuários convidados
Resposta HTTP
200 (Sucesso)
500 (Erro do Servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
Solicitar amostra
{
"sub_ids":[
"[email protected]",
"[email protected]",
"[email protected]"
],
"invited_ids":[
"[email protected]"
],
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": {
"active_user_delete_status": {
"[email protected]": "FAILED"
},
"invited_user_delete_status": {
"[email protected]": "SUCCESS"
}
}
}
Amostra de erro de resposta
{
"status": "INTERNAL_SERVER_ERROR",
"code": 500,
"errorsCount": 1,
"errors": [
{
"description": "INTERNAL_SERVER_ERROR"
}
]
}
A descrição pode incluir
FALHADO
INTERNO_SERVIDOR_ERVIDOR_ERRO
Usuário inválido
Permissão de usuário inválida
Plano de usuário inválido
4. Obter usuários
URL: https://web1.remotepc.com/rpcnew/api/msp/user/list
Método-Tipo: GET
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
Int pageIndex - Opcional
Int recordPerPage - Opcional, o padrão é 500
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"pageIndex": 1,
"recordPerPage": 30
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": {
"pagination": {
"records_per_page": 30,
"total_records": 1,
"total_page_count": 1,
"current_page_index": 1
}
"users": [
{
"firstname": "firstname",
"username": "[email protected]",
"lastname": "lastname"
]
}
}
}
Amostra de erro esperada
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Invalid page index"
}
]
}
A descrição pode incluir
Usuário inválido
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
Índice de página inválido
Nota: O número máximo de listas de usuários a solicitar de uma só vez é 500.
5. Atribuir o computador ao usuário
URL: https://web1.remotepc.com/rpcnew/api/msp/computer/assign
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
string: nome de usuário - Obrigatório
string[]: nomes_do_computador - Obrigatório
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"username": "[email protected]",
"computer_names": [
"Computer A",
"Computer B"
],
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": "SUCCESS"
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Computer name can not be blank"
}
]
}
A descrição pode incluir
O nome de usuário é obrigatório
Os nomes dos computadores não são encontrados no pedido
Usuário não encontrado
Computador(es) não encontrado(s)
Usuário inválido
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
6. Desatribuir o computador ao usuário
URL: https://web1.remotepc.com/rpcnew/api/msp/computer/unassign
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
string: nome de usuário - Obrigatório
string[]: nomes_do_computador - Obrigatório
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"username": "[email protected]",
"computer_names": [
"Computer A",
"Computer B"
],
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": "SUCCESS"
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Computer names are not found in the request"
}
]
}
A descrição pode incluir
O nome de usuário é obrigatório
Os nomes dos computadores não são encontrados no pedido
Usuário não encontrado
Computador(es) não encontrado(s)
Usuário inválido
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
7. Criar grupos e mover computadores
URL: https://web1.remotepc.com/rpcnew/api/msp/computer/group/create
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
string: group_name - Obrigatório
string[]: nomes_do_computador - Opcional
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"group_name": "Group A",
"computer_names": [
"Computer A",
"Computer B"
],
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": "SUCCESS"
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Group name is already exists"
}
]
}
A descrição pode incluir
O nome de usuário é obrigatório
Os nomes dos computadores não são encontrados no pedido
Usuário inválido
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
O nome do grupo não pode estar em branco
O nome do grupo já existe
Nome do grupo inválido
8. Remover computador(es)
URL: https://web1.remotepc.com/rpcnew/api/msp/computer/remove
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação
string[]: nomes_do_computador - Obrigatório
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"computer_names": [
"Computer A",
"Computer B"
],
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": "SUCCESS"
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Computer names are not found in the request"
}
]
}
A descrição pode incluir:
Usuário inválido
Os nomes dos computadores não são encontrados no pedido
Ultrapassou o limite de computadores
Computador(es) não encontrado(s)
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
Nota: Somente computadores off-line podem ser removidos. De cada vez, até 50 computadores podem ser removidos.
9. Adicionar comentário para computador
URL: https://web1.remotepc.com/rpcnew/api/msp/computer/comments/add
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação:
string: computer_name - Obrigatório
string: comment_desc - Obrigatório
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"comment_desc": "This is my computer",
"computer_name": "Computer A"
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": "SUCCESS"
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Computer name can not be blank"
}
]
}
A descrição pode incluir
O nome de usuário é obrigatório
O nome do computador não pode estar em branco
Os comentários não podem estar em branco
O comprimento dos comentários deve ser entre 6 e 250
Computador não encontrado
Usuário inválido
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
10. Obter dispositivos
URL: https://web1.remotepc.com/rpcnew/api/msp/computer/list
Método-Tipo: GET
Solicitar cabeçalhos:
- Authorization: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação:
Int pageIndex - Opcional
Int recordPerPage - Opcional, o padrão é 500
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"pageIndex": 1,
"recordPerPage": 30
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": {
"devices": [
{
"machine_id": "###################",
"host_name": "Computer A",
"host_os_version": "10.0",
"host_ip": "0.0.0.0",
"viewer_last_session_time": "2023-02-24 11:07:11",
"comments": "",
"host_os_text": "Windows",
"host_status_text": "Offline"
}
{
"machine_id": "###################",
"host_name": "Computer B",
"host_os_version": "10.0",
"host_ip": "0.0.0.0",
"viewer_last_session_time": "2023-02-24 10:56:01",
"comments": "",
"host_os_text": "Windows",
"host_status_text": "Offline"
}
]
"pagination": {
"records_per_page": 30,
"total_records": 2,
"total_page_count": 1,
"current_page_index": 1
}
}
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Invalid page index"
}
]
}
A descrição pode incluir
Usuário inválido
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
Índice de página inválido
Nota: O número máximo de listas de dispositivos a serem solicitados de uma vez é de 500.
11. Mover computadores para um grupo
URL: https://web1.remotepc.com/rpcnew/api/msp/computer/group/move
Método-Tipo: POST
Solicitar cabeçalhos:
- Authorization header: Bearer <api key>
- Tipo de conteúdo: aplicação/json
Solicitação:
string: group_name- Obrigatório
string[]: nomes_do_computador- Obrigatório
Resposta HTTP
200 (Sucesso)
500 (Erro do servidor)
400 (Parâmetros inválidos)
401 (Não Autorizado)
403 (Pedido inválido)
404 (Não encontrado)
Solicitar amostra
{
"group_name": "Group A",
"computer_names": [
"Computer A",
"Computer B"
]
}
Amostra de resposta
{
"status": "OK",
"code": 200,
"message": "SUCCESS"
}
Amostra de erro de resposta
{
"status": "BAD_REQUEST",
"code": 400,
"errorsCount": 1,
"errors": [
{
"description": "Group name does not exists"
}
]
}
Resposta de erro esperada
Os nomes dos computadores não são encontrados no pedido
Usuário inválido
Permissão de usuário inválida
INTERNO_SERVIDOR_ERVIDOR_ERRO
Plano de usuário inválido
O nome do grupo não pode estar em branco
O nome do grupo não existe
Nome do grupo inválido