masstack

V1
API Overview Resources Schemas

Trouble Ticket

Everything about your trouble tickets

Parameters

Name In Type Required Description
body body any true trouble ticket attributes needed to create a new trouble ticket

Request body - JsonObject

1

{}
None

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


curl -X POST https://ticketing-ossj.masstack.com/troubleTicket \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'baseTroubleTicketState': 'OPENACTIVE',
  'mirrorKey': 'string',
  'dialog': 'string',
  'troubleType': 'string',
  'troubleDescription': 'string',
  'troubleDetectionTime': '2019-08-24T14:15:22Z',
  'preferredPriority': 1,
  'troubledObject': 'string',
  'customerTroubleNum': 'string',
  'homeId': 'string',
  'gescal37ID': 'string',
  'wh1Parameter': 'cliente',
  'wh2Parameter': 'string',
  'wh3Parameter': 'string',
  'wh4Parameter': 'string',
  'wh5Parameter': 'string',
  'customer': 'string',
  'clearencePerson': 'string',
  'attachments': [
    {
      'content': 'string',
      'mimeType': 'string',
      'name': 'string'
    }
  ]
}"

Responses

Code Meaning Description Schema
201 Created trouble ticket has been created successfully createTroubleTicketResponse
400 Bad Request OssjIllegalArgumentException, RemoteException Inline

201 - instance of createTroubleTicketResponse

Custom schema example

1
2
3
4

{
  "ticketId": "RED-84",
  "mirrorKey": "ONV-1024"
}
Name Type Required Description
ticketId string false none
mirrorKey string false none

Parameters

Name In Type Required Description
ticketId path string true ‘none’

Request example

1
2
3
4
5


curl -X GET https://ticketing-ossj.masstack.com/troubleTicket/{ticketId} \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK trouble ticket response troubleTicketResponse

Parameters

Name In Type Required Description
ticketId path string true ‘none’
body body any true trouble ticket object to update an existing trouble ticket

Request body - JsonObject

1

{}
None

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


curl -X PATCH https://ticketing-ossj.masstack.com/troubleTicket/{ticketId} \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'baseTroubleTicketState': 'OPENACTIVE',
  'ticketId': 'string',
  'mirrorKey': 'string',
  'dialog': 'string',
  'closeOutType': 'string',
  'closeOutNarr': 'string',
  'serviceRestoredTime': '2019-08-24T14:15:22Z',
  'customer': 0,
  'content': 'string',
  'mimeType': 'string',
  'name': 'string'
}"

Responses

Code Meaning Description Schema
200 OK trouble ticket has been updated succesfully updateTroubleTicketResponse
400 Bad Request OssjIllegalArgumentException, RemoteException, ObjectNotFoundException Inline

200 - instance of updateTroubleTicketResponse

Custom schema example

1
2
3
4
5
6
7
8
9

{
  "ticketId": "RED-84",
  "dialog": "This is a comment example",
  "troubleType": "FTTH_INS_CTO INACCESIBLE",
  "troubleDescription": "trouble description example",
  "preferredPriority": "4",
  "customerTroubleNum": "O99999990",
  "wh1Parameter": "Incidencia Mutualizada"
}
Name Type Required Description
ticketId string false none
dialog string false none
troubleType string false none
troubleDescription string false none
preferredPriority string false none
customerTroubleNum string false none
wh1Parameter string false none

Endpoints

Trouble Ticket