Save Service Request Task Data
Save Service Request Task Data API allows users to save ticket details for Service Request Tasks. The API supports both versions V1.0 and V2.0 and requires basic authentication. The request format includes various mandatory and optional columns for providing ticket details, and the output includes a status code and message indicating the success or failure of the request.
API version V1.0
API: | SaveServiceRequestTaskData |
Purpose: | To save the ticket details for Service Request Tasks . |
API URL: | http://<API URL>:<API Port>//iAutomateAPI/Request/SaveServiceRequestTaskData/1 |
Authentication type: | Basic |
Method Type: | Post |
Request Format: [ { "TicketNumber": "SCTASK0010992", "Summary": "testing", "sys_id": "945eb78e6a0ad872186c8c41c6aa42476a9d051042", "SRId": "2b535ab3dbc988506d7550d3dc96190e", "RequestItemId": " 12648887dbec9810e3bbde06f496196f ", "StatusCode": "1", "Description": "testing data", "AssignedGroup": "9365b4e90592c81e3b7a024555a6c0094ba77e8773", "CreationDate": "2020-05-07 10:36:05", "LastModifiedDate": "2020-05-07 11:24:54", "Col1": "", "Col2": "", "Col3": "", "Col4": "", "Col5": "", "TimeZone": "IST", "TimeZoneOffset": "-330", "IsTimeZoneOrOffset": "OFFSET", "IsEpoch": "N" } ] |
Column | Column Type | Mandatory | Expected/Sample value | Remarks |
TicketNumber | string | Yes | CRT0303863 | This field contains Service Request Task number |
Summary | string | Yes | testing | This field contains summary of Service Request Task |
sys_id | string | Yes | 2b535ab3dbc988506d7550d3dc96190e | This field contains unique number |
SRid | string | Yes | 2b535ab3dbc988506d7550d3dc96190e | This field contains unique number of Service Request |
RequestItemId | string | Yes | 12648887dbec9810e3bbde06f496196f | This field contains unique number of Service Request Item |
StatusCode | string | Yes | 1 | This field contains status of Service Request Task |
Description | string | Yes | testing | This field contains summary of Service Request Task |
AssignedGroup | string | No | 123456 | This field contains assignment group of Service Request Task |
CreationDate | string | Yes | 2019-11-18 06:24:52 | This field contains creation date of Service Request Task |
LastModifiedDate | string | Yes | 2019-11-18 07:24:52 | This field contains date whenever updating happen on Service Request Task |
Col1 | string | No | You can use it for any custom value | |
Col2 | string | No | You can use it for any custom value | |
Col3 | string | No | You can use it for any custom value | |
Col4 | string | No | You can use it for any custom value | |
Col5 | string | No | You can use it for any custom value | |
TimeZone | string | Value is Mandatory if "IsTimeZoneOrOffset":"TIMEZONE" | IST | It define in which format you are sending data, in use only when "IsTimeZoneOrOffset":"TIMEZONE" |
TimeZoneOffset | string | Value is Mandatory if "IsTimeZoneOrOffset":"OFFSET” | -330 | It define he offset, in use only when "IsTimeZoneOrOffset":"OFFSET" |
IsTimeZoneOrOffset | string | Yes |
TIMEZONE/ OFFSET/ GMT |
It define whether you want to use Timezone ,offset or GMT value |
IsEpoch | string | Yes | Y or N | If date format is Epoch, set this key value as "Y" else "N" |
Output: { "statusCode": 200, "status": "Success", "message": "Success", "result": "df7f533b-c0cf-44a6-9e95-0f50f00dadb9" } |
Column | Column type | value | Remarks |
statusCode | int |
Success = 200, Error = 300, RequiredAttributeValueMissing = 400, Unauthorized = 401, |
This field provide status code |
status | string | Success/Fail | This field provide status |
message | string | null or message in case of not success | |
result | string | de0e3951-4c7b-40ad-b5ce-5993d770c0a9 | This field provide unique number for reference |
API version V2.0
API: | SaveServiceRequestTaskData |
Purpose: | To save the ticket details for Service Request Tasks . |
API URL: | http://<API URL>:<API Port>/v2/serviceRequests/orgentityid/1 |
Authentication type: | Basic |
Method Type: | Post |
Request Format: [ { "TicketNumber": "SCTASK0010992", "Summary": "testing", "sys_id": "945eb78e6a0ad872186c8c41c6aa42476a9d051042", "SRId": "2b535ab3dbc988506d7550d3dc96190e", "RequestItemId": " 12648887dbec9810e3bbde06f496196f ", "StatusCode": "1", "Description": "testing data", "AssignedGroup": "9365b4e90592c81e3b7a024555a6c0094ba77e8773", "CreationDate": "2020-05-07 10:36:05", "LastModifiedDate": "2020-05-07 11:24:54", "Col1": "", "Col2": "", "Col3": "", "Col4": "", "Col5": "", "TimeZone": "IST", "TimeZoneOffset": "-330", "IsTimeZoneOrOffset": "OFFSET", "IsEpoch": "N" } ] |
Column | Column Type | Mandatory | Expected/Sample value | Remarks |
TicketNumber | string | Yes | CRT0303863 | This field contains Service Request Task number |
Summary | string | Yes | testing | This field contains summary of Service Request Task |
sys_id | string | Yes | 2b535ab3dbc988506d7550d3dc96190e | This field contains unique number |
SRid | string | Yes | 2b535ab3dbc988506d7550d3dc96190e | This field contains unique number of Service Request |
RequestItemId | string | Yes | 12648887dbec9810e3bbde06f496196f | This field contains unique number of Service Request Item |
StatusCode | string | Yes | 1 | This field contains status of Service Request Task |
Description | string | Yes | testing | This field contains summary of Service Request Task |
AssignedGroup | string | No | 123456 | This field contains assignment group of Service Request Task |
CreationDate | string | Yes | 2019-11-18 06:24:52 | This field contains creation date of Service Request Task |
LastModifiedDate | string | Yes | 2019-11-18 07:24:52 | This field contains date whenever updating happen on Service Request Task |
Col1 | string | No | You can use it for any custom value | |
Col2 | string | No | You can use it for any custom value | |
Col3 | string | No | You can use it for any custom value | |
Col4 | string | No | You can use it for any custom value | |
Col5 | string | No | You can use it for any custom value | |
TimeZone | string | Value is Mandatory if "IsTimeZoneOrOffset":"TIMEZONE" | IST | It define in which format you are sending data, in use only when "IsTimeZoneOrOffset":"TIMEZONE" |
TimeZoneOffset | string | Value is Mandatory if "IsTimeZoneOrOffset":"OFFSET” | -330 | It define he offset, in use only when "IsTimeZoneOrOffset":"OFFSET" |
IsTimeZoneOrOffset | string | Yes |
TIMEZONE/ OFFSET/ GMT |
It define whether you want to use Timezone ,offset or GMT value |
IsEpoch | string | Yes | Y or N | If date format is Epoch, set this key value as "Y" else "N" |
Output: { "Id": "5a940df1-c251-4af1-9e59-20fecd18bd7e", "Status": "Success", "Message": "Service Request data saved successfully" } |
Column | Column type | value | Remarks |
Id | string | 5a940df1-c251-4af1-9e59-20fecd18bd7e | This field provide unique number for reference |
Status | string | Success/Fail | This field provide status |
Message | string | message | Success/Fail message |