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). |
| ciName | Corda | Não | Nome do item de configuração (IC). |
| 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 | Sim | Lista de campos adicionais no caso. Se o caso a ser criado não exigir campos adicionais, coloque a matriz vazia. Ex. “listAdditionalField”: [] |
| TempItemId | Int | Não | Identificador temporário do item. isso deve ser negativo. Exemplo: -1 |
Corpo da petição
{
"categoryId": 1110,
"cause": "",
"ciId": 6955,
"ciName": "HIS ISIS PRODUCCIÓN",
"companyId": 35,
"consoleType": 1,
"correctActions": null,
"currentTime": 0,
"customerId": 19994,
"applicantId": 19994,
"description": "prueba",
"foregroundColorRgb": "255.255.255",
"followUpActions": null,
"hasMoreInformation": false,
"hasPendingSurvey": false,
"estimatedCost": 0,
"realCost": 0,
"recomendations": null,
"impactId": 3,
"incorrectActions": null,
"instance": 1782334251107,
"isFeeAvailable": true,
"itemType": 4,
"itemVersion": 3,
"knownError": null,
"majorProblem": null,
"modelId": 26,
"unitId": null,
"priorityReason": null,
"projectId": 2,
"providerId": null,
"reasonId": 340,
"registryTypeId": 11,
"groupId": 17,
"serviceId": 16,
"stateId": 204,
"subject": "CANCELAR - PRUEBA",
"surveyToken": null,
"thirdParty": null,
"transformed": false,
"listAdditionalField": [
{
"boolValue": null,
"catalogId": null,
"dataSourceId": null,
"dateValue": null,
"description": "[ES] Numero Celular",
"enable": true,
"fieldId": 455,
"fieldType": 1,
"fieldTypeName": "shortext",
"floatValue": null,
"identifier": null,
"inputStream": null,
"intValue": null,
"itemId": null,
"mandatory": true,
"name": "[ES] Numero Celular",
"order": null,
"projectId": null,
"stringValue": "123456",
"type": null,
"url": null,
"visible": true
},
{
"boolValue": null,
"catalogId": null,
"dataSourceId": null,
"dateValue": null,
"description": "[ES] Ubicación Exacta (Piso y Area)",
"enable": true,
"fieldId": 457,
"fieldType": 1,
"fieldTypeName": "shortext",
"floatValue": null,
"identifier": null,
"inputStream": null,
"intValue": null,
"itemId": null,
"mandatory": true,
"name": "[ES] Ubicación Exacta (Piso y Area)",
"order": null,
"projectId": null,
"stringValue": "Bogota",
"type": null,
"url": null,
"visible": true
},
{
"boolValue": null,
"catalogId": null,
"dataSourceId": null,
"dateValue": null,
"description": "[ES] Jefe de Area",
"enable": true,
"fieldId": 459,
"fieldType": 1,
"fieldTypeName": "shortext",
"floatValue": null,
"identifier": null,
"inputStream": null,
"intValue": null,
"itemId": null,
"mandatory": true,
"name": "[ES] Jefe de Area",
"order": null,
"projectId": 2,
"stringValue": "Cesar Munevar",
"type": null,
"url": null,
"visible": true
}
],
"authorId": 19994,
"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 |