PT
Español
English
Português
    Adicionar relações

    Detalhes da petição

    • URL base: {host}/ASMSAPI/
    • Uri: /api/v9/ci/{id}/relation
    • Tipo: POST

    • Títulos obrigatórios:

    • tipo de conteúdo: application/json
    • Autorização X: Portador {token}

    Descrição do URL

    • {host}: Ele representa o domínio do ambiente no qual a API está localizada.
    • ASMSAPI/: Prefixo de API fixo.
    • URI: Ponto de extremidade específico para a solicitação.


    ⚐ URL DE EXEMPLO:

    https://{host}/ASMSAPI/api/v9/ci/{id}/relation


    Parâmetros:

    Nome Tipo de dado Obrigatório Descrição
    Id Número Sim Identificador do IC.
    tipo de item Texto Sim Tipo de item.
    relatedItemType Texto Sim Tipo de item a ser relacionado (Incidentes, Problema, Alteração, Liberação, Chamada de Serviço, Tarefa, Manutenção, Ci, Pacotes, Contrato, Fatura, OutroDocumento, Artigo.)
    relatedItemId Número Sim Identificador do item a ser relacionado.
    relationTypeId Número Sim Identificador do tipo de relação.
    typeIsReverse Bool Sim Identificador para determinar se o CI principal com o qual o relacionamento é estabelecido é um pai ou um filho.

    Corpo da petição

    Ejemplo de relación de **CI** con **CI**. {

    "id": 147,
    "itemType": "ci",
    "relatedItemId": 1035,
    "relatedItemType": "ci",
    "relationTypeId": 139,
    "typeIsReverse": true


}

Ejemplo de cuerpo de la relación de ***CI*** con ***Article***: {

    "id": 147,
    "itemType": "ci",
    "relatedItemId": 58,
    "relatedItemType": "article",
    "relationTypeId": 137,
    "typeIsReverse": true

}

*Respuesta*

{
    "result": true 
}

    Parâmetros de resposta

    Nome Tipo de dado Descrição
    resultado Booleano Indica se a operação foi bem-sucedida

    Mensagens de erro

    Código Status HTTP Mensagem de erro
    400 Solicitação BadRequest \r\nNome do parâmetro: id
    400 Solicitação BadRequest InvalidItemType
    400 Solicitação BadRequest InvalidRelatedItemId
    400 Solicitação BadRequest InvalidRelatedItemType
    400 Solicitação BadRequest InvalidRelationTypeId
    400 Solicitação BadRequest InvalidProjectId
    400 Solicitação BadRequest RequestNeedsSomeArguments
    403 Proibido DoNotHavePermissionForThisAction
    500 Erro de servidor interno FailureAddRelatedItem