API Operations

Data Transfer Objects

The Issuetrak API uses the concept of Data Transfer Objects (DTOs) to represent the serialized input to API operation endpoints for API methods that use the POST and PUT HTTP verbs and to represent the serialized output from API operations where a response object is expected.


 

Date Serialization

For serializing dates, the Issuetrak API uses the ISO 8601 standard.

Example:

The date February 27, 2014, at 11:30:10 AM, is represented in the ISO 8601 standard as: 2014-02-27T11:30:10.0000000.


 

Data Serialization

The Issuetrak API supports two serialization formats: JSON and XML. The documentation assumes the use of JSON; however, the Issuetrak API Swagger UI demonstrates the alternate serialization response schema for XML if an XML implementation is desired.


 

ExtensionData and MetaData Objects

For API operation responses that generate DTOs or collections of DTOs, there are two additional properties that will be present within each of the DTO instances, “ExtensionData” and “Metadata”.

The ExtensionData property represents a collection of key / value pairs and is intended to provide a container for conveying data that is external to an established data contract. One of the primary uses of this property would be to convey data from a future version of a DTO contract (e.g., a future version of a response DTO from a version X implementation of the Issuetrak API) to a previous DTO version.

The Metadata property represents a collection of key / value pairs and is intended to provide a container for conveying data that pertinent to the individual API operation. For API operations that produce response DTO instances, the Metadata collection will include at least two properties: “APIVersion” and “QueryDate”. The “APIVersion” property will provide a text representation of the version of the API used to generate the response, e.g., “v1”. The “QueryDate” property will provide an ISO 8601 serialized date representing the date-time that the API operation was run.

API Operations for APIMETADATA

API Operations for Attachments

API Operations for Causes

API Operations for Classes

API Operations for Departments

API Operations for Issues

API Operations for IssueTypes

API Operations for IssueSubTypes

API Operations for IssueSubTypes2

API Operations for IssueSubTypes3

API Operations for IssueSubTypes4

API Operations for Locations

API Operations for MenuItems

API Operations for Notes

API Operations for Organizations

API Operations for Priorities

API Operations for Projects

API Operations for ServiceLevels

API Operations for ServiceLevelAgreements

API Operations for ServiceLevelSeverities

API Operations for ServiceLevelTerms

API Operations for Substatuses

API Operations for TimeZones

API Operations for Users

API Operations for User Types

API Operations for User-Defined Field Types