Diferente do que está descrito na documentação oficial do GLPI, o sistema não funciona como deveria e não responde corretamente aos parâmetros fornecidos. A documentação encontrada em "https://DOMINIO_GLPI.COM/apirest.php"
informa que alguns parâmetros devem ser passados no corpo da requisição, mas isso nem sempre funciona. O único jeito que parece funcionar é passando os parâmetros diretamente na URL.
Autor: joaoprd | joaopedrord2001@gmail.com
Iniciando sessão
Para iniciar qualquer chamada, precisamos do session_token e do app-token. Para gerar o session_token, fazemos uma requisição para "https://DOMINIO_GLPI//apirest.php/initSession"
com os parâmetros app-token e user_token, que estão disponíveis na conta do usuário com a qual estamos trabalhando.
A requisição abaixo gera o session_token:
curl --location 'https://DOMINIO_GLPI.COM/apirest.php/initSession?app-token={YOUR-APP-TOKEN}&user_token={YOUR-USER-TOKEN}'
Pesquisa de tickets
Com o session_token
em mãos, podemos realizar pesquisas sobre os chamados. No entanto, de acordo com a documentação do GLPI, parece que o endpoint não funciona conforme os exemplos fornecidos, pois não é permitido enviar PAYLOAD para esse endpoint, resultando no seguinte erro:
[
"ERROR_JSON_PAYLOAD_FORBIDDEN",
"GET Request should not have json payload (http body); view documentation in your browser at /#ERROR_JSON_PAYLOAD_FORBIDDEN"
]
Para contornar essa limitação, vamos passar os parâmetros diretamente na URL da requisição, utilizando o link "https://DOMINIO_GLPI.COM/apirest.php/search/Ticket"
. É necessário incluir o app-token
e o session-token
para se conectar, e em seguida, adicionar os filtros desejados para localizar as informações necessárias.
curl --location --globoff 'https://DOMINIO_GLPI.COM/apirest.php/search/Ticket
?app-token={YOUR-APP-TOKEN}
&session_token={YOUR-SESSION-TOKEN}
&criteria[0][field]=1
&criteria[0][searchtype]=contains
&criteria[0][value]=Verifica%C3%A7%C3%A3o%20diaria
&criteria[1][link]=AND
&criteria[1][field]=12
&criteria[1][searchtype]=equals
&criteria[1][value]=2
&glpilist_limit=1000' \
--header 'Content-Type: application/json'
"Criteria" é a chamada de filtro, os fields são determidos filtros a serem colocados para encontrar algo. Por exemplo, "criteria[0][field]=1" é designado para o título onde passamos "criteria[0][searchtype]=contains" informando que contém "criteria[0][value]=Verifica%C3%A7%C3%A3o%20diaria", no caso seria 'Verificação diária' que foi encodado, mas ali seria o local a colocar o título do chamado. É feito outra filtragem abaixo em criteria[1][link]=AND, onde se é feito o AND informando uma nova pesquisa seguindo a anterior.
Para analisar todas as filtragens pode-se fazer a requisição para:
curl --location 'https://DOMINIO_GLPI.COM/apirest.php/listSearchOptions/Ticket?app-token={YOUR-APP-TOKEN}&session_token={YOUR-SESSION-TOKEN}' \
--data ''
Alguns retornos para exemplo:
{
"common": {
"name": "Características"
},
"1": {
"name": "Título",
"table": "glpi_tickets",
"field": "name",
"datatype": "itemlink",
"nosearch": false,
"nodisplay": false,
"available_searchtypes": [
"contains",
"notcontains"
],
"uid": "Ticket.name"
},
"21": {
"name": "Descrição",
"table": "glpi_tickets",
"field": "content",
"datatype": "text",
"nosearch": false,
"nodisplay": false,
"available_searchtypes": [
"contains",
"notcontains"
],
"uid": "Ticket.content"
},
"2": {
"name": "ID",
"table": "glpi_tickets",
"field": "id",
"datatype": "number",
"nosearch": false,
"nodisplay": false,
"available_searchtypes": [
"contains",
"notcontains"
],
"uid": "Ticket.id"
},
...
Criação de tarefa
Com a requisição anterior, realizamos a busca dos chamados, que retornarão em formato JSON. Com essas informações, podemos realizar as tratativas necessárias. No caso específico desta documentação, vamos fechar o chamado. No entanto, antes de fechar o chamado completamente, precisamos criar uma tarefa vinculada ao ticket que deve ser concluída.
Alguns sistemas GLPI requerem o fechamento de chamados de formas específicas. No sistema em que estou trabalhando, é necessário criar uma tarefa e uma solução antes de fechar o chamado.
Abaixo está a requisição que cria a tarefa no ticket (lembre-se de que o ticket que estou passando foi gerado na busca anterior em "Pesquisa de tickets"). Em meu código de automação, foi implementado um loop para processar todos os tickets retornados, mas isso não será abordado nesta documentação.
curl --location 'https://DOMINIO_GLPI.COM/apirest.php/TicketTask?session_token={YOUR-SESSION-TOKEN}' \
--header 'app_token: {YOUR-APP-TOKEN}' \
--header 'Authorization: user_token {YOUR-USER-TOKEN}' \
--header 'Content-Type: application/json' \
--data '{
"input": {
"tickets_id": 2408020023,
"taskcategories_id": 0,
"content": "Verificação diária - Tarefa realizada.",
"actiontime": 60,
"state": 3
}
}
'
Devemos observar que, em todos os casos, passamos o app_token
no header, e o Authorization
, que contém o user_token
para autenticação da API.
Pontos importantes a serem considerados são os parâmetros passados no corpo da requisição:
- content: O conteúdo que será inserido na tarefa.
- actiontime: O tempo gasto na tarefa.
- state: O estado que o chamado terá após a criação da tarefa.
Fechamento do chamado
Com a tarefa adicionada ao chamado, é necessário apenas realizar o fechamento do chamado, que segue o mesmo processo utilizado para adicionar a tarefa.
Utiliza-se a seguinte requisição:
curl --location --request PUT 'https://DOMINIO_GLPI.COM/apirest.php/Ticket/2408020023?session_token={YOUR-SESSION-TOKEN}' \
--header 'app_token: {YOUR-APP-TOKEN}' \
--header 'Authorization: user_token {YOUR-USER-TOKEN}' \
--header 'Content-Type: application/json' \
--data '{
"input": {
"status": 6,
"solution": "<p>Chamado finallizado</p>",
"content": "<p>Chamado finallizado</p>",
"solutiontypes_id": 3,
"solutiontemplates_id": 5
}
}'
'
O status: 6
indica o fechamento do chamado. Para isso, é necessário passar o solution
e o content
como os textos do corpo para a solução. Um ponto importante nessa requisição é o solutiontemplates_id
, que deve ser criado pelo administrador do sistema GLPI, sendo esse ID um referencial para uma solução padrão.
Top comments (2)
Oi João, parabéns pelo Post, se possível poderia compartilhar o seu script completo no GIT, vai ajudar muito a comunidade, estou iniciando na integração do GLPI com a o Spectrum, a abertura de chamados já está funcionando bem, ainda preciso amadurecer algumas questões, como inserir um acompanhamento quanto já tiver um chamado aberto com o mesmo titulo, e fechar os chamados, eu já escrevo o id do alerta no chamado, preciso agora conseguir pegar essa variável no chamado quando o alerta normalizar e fechar o chamado.
Opa, vou subir e deixar por aqui o script e obrigado rsrs
Essa variável não volta em um json ou algo assim do Spectrum?