Data types

API返回并接受JSON values, which can be strings in double quotes, numbers, objects, arrays, true or false, or null. Most programming languages have tools to parse this data. SeeWorking with JSONfor a few languages.

ID integers

Most Zendesk Support resources, such as tickets and users, are identified by the integer specified by theidattribute of API responses. The term refers to the JSON numeric type, not a C-likeintdata type.

The default numeric type in JavaScript, Ruby, Python, and PHP is sufficient to represent Zendesk Support ID integers.

If you use a static-typed language where integer types are declared explicitly, use a 64-bit integer type (signed is OK) for Zendesk Support ID integers. For example, in Java or C#, use thelongtype, notint.

Time stamps

Time stamps use UTC time and are formatted asISO 8601strings. Example: "2015-04-16T09:14:57Z".

Some endpoints use Unix time, also known as Epoch or POSIX time. Example: "1455821369". SeeUnix timefor more information.

Locales

Locales are returned and passed as strings. Example: "en-us".