Detalles de la petición
- URL Base: {host}/ASMSAPI/
- Uri: api/v9/item/{id}/{itemType}/{relatedItemId}/{relatedItemType}/relation/?relationTypeId={relationTypeId}&isReverse={isReverse}&isSolution={isSolution}&isClosed={isClosed}
- Tipo: DELETE
-
Encabezados requeridos:
- content-type: application/json
- X-Authorization: Bearer {token}
Descripción de la URL
- {host}: Representa el dominio del ambiente en el que se encuentra la API.
- ASMSAPI/: Prefijo fijo de la API.
- Uri: Endpoint específico para la petición.
⚐ EJEMPLO URL:
https://{host}/ASMSAPI/v9/item/{id}/{itemType}/{relatedItemId}/{relatedItemType}/relation/?relationTypeId={relationTypeId}&isReverse={isReverse}&isSolution={isSolution}&isClosed={isClosed}
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, para la única relación que no es obligatoria es para la relación entre Caso y artículos. |
| isSolution | bool | No | Para la única relación que SÍ obligatoria es para la que se haría entre casos. |
| IsReverse | bool | No | Solo es obligatorio para cuando los tipos de caso son: - Incidents - Problem - Change - Release - ServiceCall - Task - Maintenance |
| IsClosed | bool | Si | Establece si el caso que se va a relacionar se encuentra en estado cerrado o abierto. |
Ejemplos de uri
Eliminar relaciones de casos con:
- Incidents
- api/v9/item/104081/incidents/104082/incidents/relation/?relationTypeId=140&isReverse=true&isClosed=false
- CI
- api/v9/item/104081/incidents/146/ci/relation/?relationTypeId=40&isReverse=null&isSolution=false&isClosed=false
Cuerpo de la petición
N/A
Respuesta
El servicio retorna un Json con la siguiente información:
{ “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 | \r\nNombre del parámetro: ItemType |
| 400 | BadRequest | \r\nNombre del parámetro: RelatedItemId |
| 400 | BadRequest | \r\nNombre del parámetro: RelatedItemtype |
| 400 | BadRequest | RequestNeedsSomeArguments |
| 403 | Forbidden | DoNotHavePermissionForThisAction |
| 500 | InternalServerError | FailureDeleteRelatedItem |