Create Ticket

Release Time

12/15/2017

Views

8351 times

Tags

ticket service desk APIs execution Header

Description

Creates a new ticket in Service Desk.

URL: https://subdomain.domainname/clientapi /index.php?serviceName=createticket

This function can be executed via following url: https://subdomain.domainname/clientapi

Input Parameters

Name	Required/Optional	Type	Description
email	Required	varchar(255)	Client E-mail
summary	Required	varchar(255)	Ticket Detail
description	Required	text	Ticket Detail
Asset Type	Required	int	Ticket Asset Type
Help Topic	Required	int	Ticket Help Topic
Category	Optional	text	Ticket Category
Field	Optional	int(11)	Attached File ID
CustomFileds	Optional	json	Custom Field Values
priorityId	Optional	int	Set priority values 1 : Low 2 : Normal 3 : High 4 : Critical

Input Header Parameters

Name	Required/Optional	Type	Description
Content-Type	Required	application/json	Content Type
Authorization	Required *	base64	Valid Api Key from SD Manage -> Api Keys
X-ACCESS-TOKEN	Required*	string	Valid Access Token from C1 Portal auth/login service also see 3rd Party Authentication API Definition https://developer.comodo.com/frontend/web/topic/comodo-one-3rd-party-company-api-definition https://developer.comodo.com/frontend/web/topic/token-validation-service https://developer.comodo.com/frontend/web/topic/token-renew-service
* Customer should send Authorization or X-ACCESS-TOKEN

Execution

Sample execution can be handled via Postman Application.

	{
	"email": "email",
	"summary": "ticket Title",
	"description": "Ticket Details",
	"assetType": "Ticket Asset Number",
	"helpTopic": "Ticket Help Topic",
    "category": "Ticket Category",
	"fileId":	 "fileId",
	"customFields" : {
		"fieldName-TypeText" : "Text Value",
		"fieldName-TypeDatetime" : "YYYY-MM-DD hh:mm:ss",
		"fieldName-TypePhoneNumber" : "12345X123",
		"fieldName-TypeBoolean" : true/false,
		"fieldName-TypeChoices" : "Selected choice value from a pre-defined list",
		"fieldName-TypePriority" : "Selected priority ID",
		"fieldName-TypeAsset" : "Selected asset type ID",
		"fieldName-TypeCategory" : "Selected category ID",
		"fieldName-TypeCustomList" : "Selected list-item ID",
		...
	}
	}

Header part can be handled via Postman Application

Header part can be handled via Postman Application
Content-Type : application/json
Authorization : B8ADA99D912E48A8735D3291CE60493A 
X-ACCESS-TOKEN : eyJhbGciOiJIUzI1NiJ9.eyJyZXF1ZXN0ZWRCeSI6InNkIiwibmJmIjoxNDk5MjUzNjk4LCJzY29wZSI6InNkc3RhZ2luZy1tc3AiLCJpc3MiOiJjMXBvcnRhbCIsImN1c3RvbWVySWQiOiI1OTJmYmRjZWRiYTcwYTExNTQzMWExZTUiLCJleHAiOjE0OTkyNTcyOTgsInRva2VuVHlwZSI6ImJlYXJlciIsImlhdCI6MTQ5OTI1MzY5OCwidXNlcklkIjoiMTI0MTI0MTEyNCIsImp0aSI6ImVmNjhhOTA1ODNjOWVhNjQ5ZTI4OWNkNmZkMGVhM2VhNDQ5Y2Q1N2QyNGYxMjQxYTY1MzNlYjBlNTZmMDZmMTgyY2FlNmE3NWViMmMwODA5In0.hKqaMAH2JNCfeG_OWv1TXVeKIzjgvZC7xo887Zt85ZA

Success Output

	{
     "status": "SUCCESS",
     "code": 200,
     "message": "Ticket Created",
     "data": {
          "ticketId": "662"
     }
	}

Error Output

	{
     "status": "ERROR",
     "code": 400,
     "message": "unexpected error occurred!",
     "data": null
	}
	{
"status": "ERROR",
"code": 401,
"message": "Access Denied!",
"data": null
	}