Detalles de la petición
- Uri: /api/v9/item/{id}/relation
- Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- X-Authorization: Bearer {token}
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| id | Número | Si | Identificador del caso |
| itemType | Texto | Si | Tipo de caso |
| relatedItemType | Texto | Si | Tipo de caso a relacionar |
| relatedItemId | Número | Si | Identificador del ítem a relacionar |
| relationTypeId | Número | Si | Identificador del tipo de relación; no es obligatorio para el tipo de relación con artículos. |
| isSolution | bool | No | Indica si un artículo es solución; solo es obligatorio para cuando se va a relacionar un artículo con el caso |
| typeIsReverse | bool | No | Solo es obligatorio para cuando los tipos de caso son: - Incidents - Problem - Change - Release - ServiceCall - Task - Maintenance |
Cuerpo de la petición
Ejemplo de relación de **incidente** con **artículo**. {
"itemType":"Incidents", "relatedItemType":"Article", "relatedItemId":1704, "isSolution":"true"
}
Ejemplo de cuerpo de la relación de ***Incidente*** con ***ServiceCall***: {
"itemType":"1",
"relatedItemType":"1",
"relatedItemId":3328,
"relationTypeId":8,
"typeIsReverse":"false"
}
Ejemplo de ítem con ***ci***
{
"itemType":"Incidents",
"relatedItemType":"Ci",
"relatedItemId":890,
"relationTypeId":65,
"typeIsReverse":"false" }
*Respuesta*
{
"result": true }
Parámetros Response
| Nombre | Tipo de dato | Descripción |
|---|---|---|
| result | Booleano | Indica si la operación se realizó con éxito |
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | \r\nNombre del parámetro: Id |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelatedItemId |
| 400 | BadRequest | InvalidRelatedItemType |
| 400 | BadRequest | InvalidRelationTypeId |
| 400 | BadRequest | InvalidProjectId |
| 400 | BadRequest | RequestNeedsSomeArguments |
| 403 | Forbidden | DoNotHavePermissionForThisAction |
| 500 | InternalServerError | FailureAddRelatedItem |