Criação de caso | Manual de integração da API do ASMS (v9)

Español

English

Português

Esta operação cria um caso e quando é criado, salva os anexos, tanto do caso quanto de seus campos adicionais; Depois de salvá-los, exclua os arquivos da pasta temporária criada para esse fim.

Detalhes da petição

URL base: {host}/ASMSAPI/
Uri: api/v9/item
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/item

Parâmetros:

Nome	Tipo de dado	Obrigatório	Descrição
applicantId	Int	Não	Identificador do solicitante de ocorrência.
authorId	Int	Não	Identificador do autor do caso.
ID da categoria	Int	Sim	Identificador de categoria de caso.
causa	Corda	Não	Descrição da causa raiz do problema, aplicável somente quando o tipo de item (itemType) é 2, indicando que é um problema.
CiId	Int	Não	Identificador de item de configuração (CI).
ID da empresa	Int	Não	Identificador da empresa.
tipo de console	Corda	Sim	O tipo de console usado para criar o caso (Especialista = 1, Cliente = 2, Administrador = 3, CMDB = 4).
ID do cliente	Int	Não	ID do cliente.
Descrição	Corda	Não	Descrição do caso, pode incluir conteúdo HTML.
ID do grupo	Int	Não	Identificador do grupo de especialistas associado ao caso.
Identificação de impacto	Int	Não	Identificador de impacto.
tipo de item	Int	Sim	Tipo de caso: 1. Incidente 2. Problema 3. Mudança 4. Requisito de serviço 13. Lançamento
Versão do item	Int	Não	Versão do caso.
identificação do local	Int	Não	Identificador de localização.
ID do modelo	Int	Sim	Identificador do modelo operacional.
ID de prioridade	Int	Não	Identificador de prioridade.
ID do projeto	Int	Sim	ID do projeto.
ID do provedor	Int	Não	Identificador do fornecedor.
razão	Int	Não	Identificador do motivo.
ID do tipo de registro	Int	Não	Tipo de registro de caso.
responsávelId	Int	Não	Identificador da pessoa responsável pelo caso.
ID do serviço	Int	Sim	Identificador de serviço.
Identificação do estado	Int	Sim	Identificador de status de caso inicial.
Assunto	Corda	Não	Objeto do caso.
urgencyId	Int	Não	Identificador de urgência
listAdditionalField	Array	Não	Lista de campos adicionais no caso.
TempItemId	Int	Não	Identificador temporário do item. isso deve ser negativo. Exemplo: -1

Corpo da petição

{

"categoryId": 623, "cause": null, "ciId": null, "companyId": 578,

"consoleType": "specialist", "correctActions": null, "currentTime": 0, "customerId": null, "description": "Test postman ", "foregroundColorRgb": "", "followUpActions": null, "hasMoreInformation": false, "hasPendingSurvey": false, "estimatedCost": 0,

"realCost": 0, "recomendations": null, "impactId": 7203, "incorrectActions": null, "instance": 1632253928839, "isFeeAvailable": true, "itemType": 4,

"itemVersion": 0, "knownError": null, "majorProblem": null, "modelId": 70,

"unitId": null, "priorityReason": "", "projectId": 19,

"providerId": null,

"reasonId": null, "registryTypeId": 7199, "serviceId": 140,

"stateId": 267,

    "subject": "Prueba póstman",

    "surveyToken": "",

    "thirdParty": null,

    "transformed": false,

    "listAdditionalField": [

        {

            "boolValue": null,

            "catalogId": null,

            "dataSourceId": null,

            "dateValue": null,

            "description": "[ES] Nombre Aplicativo",             "enable": true,

            "fieldId": 977,

            "fieldType": 3,

            "fieldTypeName": "List",

            "floatValue": null,

           "identifier": "A001",

            "inputStream": null,

            "intValue": 118,

            "itemId": null,

            "mandatory": true,

            "name": "[ES] Software 1",

            "order": 1,

            "projectId": null,

            "stringValue": "Aranda Data Safe",

            "type": null,

            "url": null,

            "visible": true

        },

        {

             "boolValue": null,

             "catalogId": null,

             "dataSourceId": null,

             "dateValue": null,

             "description": "[ES] Nombre Aplicativo",             "enable": true,

             "fieldId": 978,

             "fieldType": 3,

             "fieldTypeName": "List",

             "floatValue": null,

             "identifier": "A002",

             "inputStream": null,

             "intValue": 146,

             "itemId": null,

             "mandatory": true,

             "name": "[ES] Software 2",

             "order": 2,

             "projectId": null,

             "stringValue": "Aranda Virtual Support",             "type": null,

             "url": null,

             "visible": true

         },

         {

             "boolValue": null,

             "catalogId": null,

             "dataSourceId": null,

             "dateValue": null,

             "description": "[ES] Nombre Aplicativo",             "enable": true,

             "fieldId": 979,

             "fieldType": 3,

             "fieldTypeName": "List",

             "floatValue": null,

             "identifier": "A003",

             "inputStream": null,

             "intValue": 156,

             "itemId": null,

             "mandatory": true,

             "name": "[ES] Software 3",

             "order": 3,

             "projectId": null,

             "stringValue": "Aranda Field Service",

             "type": null,

             "url": null,

             "visible": true

         },

         {

             "boolValue": null,

             "catalogId": null,

             "dataSourceId": null,

             "dateValue": null,

             "description": "[ES] Nombre Aplicativo",             "enable": true,

             "fieldId": 980,

             "fieldType": 3,

             "fieldTypeName": "List",

             "floatValue": null,

             "identifier": "A004",

             "inputStream": null,

             "intValue": 176,

             "itemId": null,

             "mandatory": true,

             "name": "[ES] Software 4",

             "order": 4,

             "projectId": null,

             "stringValue": "Aranda Path Management",             "type": null,

             "url": null,

             "visible": true

         }

     ],

     "authorId": 4832,

    "tempItemId": -3

}

Responder

{

      "id": 84486,

      "idByProject": "RF-84486-19-407613" }

Parâmetros de resposta:

Nome	Tipo de dado	Descrição
Id	Int	ID do caso
idByProject	Corda	Identificador de caso por projeto

Mensagens de erro

Código	Status HTTP	Mensagem de erro
400	Solicitação BadRequest	\r\nNome do parâmetro: ConsoleType
400	Solicitação BadRequest	\r\nNome do parâmetro: ItemType
400	Solicitação BadRequest	\r\nNome do parâmetro: ListAdditionalField
400	Solicitação BadRequest	\r\nNome do parâmetro: TempItemId
400	Solicitação BadRequest	InvalidItemType
400	Solicitação BadRequest	ModelIdIsEmpty
400	Solicitação BadRequest	RequestNeedsSomeArguments
400	Solicitação BadRequest	StateIdIsEmpty
403	Proibido	DoNotHavePermissionForThisAction
500	Erro de servidor interno	FailureAddItem