Detalles de la petición
-
URI: api/v8.6/item/update/{id}/{itemType}/{userId}
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros
Nombre | Tipo de dato | Obligatorio | Descripción |
---|---|---|---|
Id | Texto | Si | Id del caso a consultar |
itemType | Número | Sí | Tipo de caso a crear. Las opciones son: 1. Incidente 2. Problema 3.Cambio |
userId | Número | Si | Id del usuario que consulta el caso. |
Adicionalmente es posible enviar como parámetros en el cuerpo de la petición los valores que se quieren editar. Estos valores corresponden a los mismos disponibles en el proceso de creación, sin embargo, existen algunos que no son editables, por ejemplo, el id del autor.
Cuerpo de la petición
La petición consiste de un arreglo json de tipo field-value con los posibles parámetros según se requiera. Ejemplo:
[
{"Field":"SpecialistId","Value":####},
{"Field":"ImpactId","Value":#},
{"Field":"Description","Value":"New description"}
]
Respuesta
Como respuesta se obtiene un objeto json, con la siguiente información:
[
{
"Field": "itemId",
"Value": "4158"
},
{
"Field": "qs",
"Value": "?64B24DED26791E23A72364E9AF0E0430E93E2CF2F6D66AA4CB23CAAF7D8F"
},
{
"Field": "composedItemId", "Value": "IM-55175-2-19537"
},
{
"Field": "isClosed",
"Value": "False"
},
{
"Field": "result",
"Value": "True"
}
]
Mensajes de error
Código | Estado HTTP | Mensaje de error |
---|---|---|
400 | BadRequest | InvalidToken |
400 | BadRequest | InvalidUserId |
400 | BadRequest | InvalidItemId |
400 | BadRequest | InvalidItemType |
400 | BadRequest | InvalidComposedItemId |
400 | BadRequest | InvalidCaseData |
400 | BadRequest | InvalidAuthorId |
400 | BadRequest | InvalidCategory |
400 | BadRequest | InvalidCompany |
400 | BadRequest | InvalidDescription |
400 | BadRequest | InvalidGroup |
400 | BadRequest | InvalidItemType |
400 | BadRequest | InvalidStateConfiguraton |
400 | BadRequest | InvalidRegistryType |
400 | BadRequest | InvalidService |
400 | BadRequest | InvalidSla |
400 | BadRequest | InvalidUrgencyId |
401 | Unauthorized | UnauthorizedDescriptionModification |
401 | Unauthorized | UnauthorizedIncidentModification |
401 | Unauthorized | UnauthorizedChangeModification |
401 | Unauthorized | UnauthorizedProblemModification |
401 | Unauthorized | UnauthorizedServicecallModification |
404 | NotFound | InvalidItemId |