Sample code for 30+ languages & platforms
Unicode C++ Requires Chilkat v11.0.0+

Jira Cloud: Discover Service Desks and Request Types

See more Jira Examples

List accessible service desks, find one by its project key, list its request types, and retrieve the required fields for a request type selected by name. Use the returned service desk ID and request type ID in the customer-request creation example.

Request types are portal-facing forms and are not interchangeable with Jira issue types. Their fields, allowed values, and required flags can differ from the platform create-issue metadata. Access depends on the account's customer or agent role. OAuth integrations need the Service Management scopes documented for these operations.

The code uses an Atlassian account email and an API token without scopes with the site URL. For a scoped API token, keep Basic authentication and change baseUrl to https://api.atlassian.com/ex/jira/YOUR_CLOUD_ID. For OAuth2, use that gateway URL, omit Login/Password/BasicAuth, and set http.AuthToken to the access token. See API token authentication and OAuth2 authorization. The account must have permission for the operation; OAuth scopes do not grant additional Jira permissions.

Targets Jira Cloud. Jira Data Center has a separate REST API and may require different paths, authentication, or payloads.

Atlassian REST API documentation

Chilkat Unicode C++ Downloads

Unicode C++
#include <CkHttpW.h>
#include <CkStringBuilderW.h>
#include <CkHttpResponseW.h>
#include <CkJsonObjectW.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.

    CkHttpW http;
    http.put_RequireSslCertVerify(true);
    http.put_BasicAuth(true);
    //  Read these credentials from private application configuration.
    http.put_Login(L"YOUR_ATLASSIAN_EMAIL");
    http.put_Password(L"YOUR_API_TOKEN");
    const wchar_t *baseUrl = L"https://your-domain.atlassian.net";
    http.put_Accept(L"application/json");
    CkStringBuilderW url;
    CkHttpResponseW resp;
    CkJsonObjectW reply;
    const wchar_t *projectKey = L"SUPPORT";
    const wchar_t *requestTypeName = L"General request";
    const wchar_t *serviceDeskId = L"";
    const wchar_t *requestTypeId = L"";
    int deskMatches = 0;
    int typeMatches = 0;
    int desksStart = 0;
    bool desksMore = true;
    CkStringBuilderW desksOffset;
    while ((desksMore == true)) {
        desksOffset.Clear();
        desksOffset.AppendInt(desksStart);
        http.SetUrlVar(L"offset",desksOffset.getAsString());
        url.SetString(baseUrl);
        url.Append(L"/rest/servicedeskapi/servicedesk?start={$offset}&limit=50");
        success = http.HttpNoBody(L"GET",url.getAsString(),resp);
        if (resp.get_StatusCode() == 0) {
            wprintf(L"No HTTP response was received. Check connectivity and TLS settings.\n");
            return;
        }

        if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
            wprintf(L"Request failed. HTTP %d\n",resp.get_StatusCode());
            if (resp.get_StatusCode() == 429) {
                wprintf(L"Rate limited. Retry-After: %s\n",resp.getHeaderField(L"Retry-After"));
            }

            //  Inspect this response locally; it can contain private Jira data.
            wprintf(L"%s\n",resp.bodyStr());
            return;
        }

        success = reply.Load(resp.bodyStr());
        if (success != true) {
            wprintf(L"Expected a JSON object in the response.\n");
            return;
        }

        if (reply.JsonTypeOf(L"values") != 4) {
            wprintf(L"Expected an array: values\n");
            return;
        }

        int desksCount = reply.SizeOfArray(L"values");
        int desksIndex = 0;
        while ((desksIndex < desksCount)) {
            reply.put_I(desksIndex);
            wprintf(L"%s  %s  Service desk ID: %s\n",reply.stringOf(L"values[i].projectKey"),reply.stringOf(L"values[i].projectName"),reply.stringOf(L"values[i].id"));
            if (reply.StringOfEquals(L"values[i].projectKey",projectKey,true) == true) {
                serviceDeskId = reply.stringOf(L"values[i].id");
                deskMatches = deskMatches + 1;
            }

            desksIndex = desksIndex + 1;
        }

        desksStart = desksStart + desksCount;
        desksMore = (reply.BoolOf(L"isLastPage") != true);
        if ((desksMore == true) && (desksCount == 0)) {
            wprintf(L"Pagination made no progress; stopping.\n");
            return;
        }

    }

    if (deskMatches != 1) {
        wprintf(L"Expected exactly one matching service desk.\n");
        return;
    }

    http.SetUrlVar(L"serviceDeskId",serviceDeskId);
    int typesStart = 0;
    bool typesMore = true;
    CkStringBuilderW typesOffset;
    while ((typesMore == true)) {
        typesOffset.Clear();
        typesOffset.AppendInt(typesStart);
        http.SetUrlVar(L"offset",typesOffset.getAsString());
        url.SetString(baseUrl);
        url.Append(L"/rest/servicedeskapi/servicedesk/{$serviceDeskId}/requesttype?start={$offset}&limit=50");
        success = http.HttpNoBody(L"GET",url.getAsString(),resp);
        if (resp.get_StatusCode() == 0) {
            wprintf(L"No HTTP response was received. Check connectivity and TLS settings.\n");
            return;
        }

        if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
            wprintf(L"Request failed. HTTP %d\n",resp.get_StatusCode());
            if (resp.get_StatusCode() == 429) {
                wprintf(L"Rate limited. Retry-After: %s\n",resp.getHeaderField(L"Retry-After"));
            }

            //  Inspect this response locally; it can contain private Jira data.
            wprintf(L"%s\n",resp.bodyStr());
            return;
        }

        success = reply.Load(resp.bodyStr());
        if (success != true) {
            wprintf(L"Expected a JSON object in the response.\n");
            return;
        }

        if (reply.JsonTypeOf(L"values") != 4) {
            wprintf(L"Expected an array: values\n");
            return;
        }

        int typesCount = reply.SizeOfArray(L"values");
        int typesIndex = 0;
        while ((typesIndex < typesCount)) {
            reply.put_I(typesIndex);
            wprintf(L"Request type: %s  ID: %s\n",reply.stringOf(L"values[i].name"),reply.stringOf(L"values[i].id"));
            if (reply.StringOfEquals(L"values[i].name",requestTypeName,true) == true) {
                requestTypeId = reply.stringOf(L"values[i].id");
                typeMatches = typeMatches + 1;
            }

            typesIndex = typesIndex + 1;
        }

        typesStart = typesStart + typesCount;
        typesMore = (reply.BoolOf(L"isLastPage") != true);
        if ((typesMore == true) && (typesCount == 0)) {
            wprintf(L"Pagination made no progress; stopping.\n");
            return;
        }

    }

    if (typeMatches != 1) {
        wprintf(L"Expected exactly one matching request type.\n");
        return;
    }

    http.SetUrlVar(L"requestTypeId",requestTypeId);
    url.SetString(baseUrl);
    url.Append(L"/rest/servicedeskapi/servicedesk/{$serviceDeskId}/requesttype/{$requestTypeId}/field");
    success = http.HttpNoBody(L"GET",url.getAsString(),resp);
    if (resp.get_StatusCode() == 0) {
        wprintf(L"No HTTP response was received. Check connectivity and TLS settings.\n");
        return;
    }

    if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
        wprintf(L"Request failed. HTTP %d\n",resp.get_StatusCode());
        if (resp.get_StatusCode() == 429) {
            wprintf(L"Rate limited. Retry-After: %s\n",resp.getHeaderField(L"Retry-After"));
        }

        //  Inspect this response locally; it can contain private Jira data.
        wprintf(L"%s\n",resp.bodyStr());
        return;
    }

    success = reply.Load(resp.bodyStr());
    if (success != true) {
        wprintf(L"Expected a JSON object in the response.\n");
        return;
    }

    if (reply.JsonTypeOf(L"requestTypeFields") != 4) {
        wprintf(L"Expected an array: requestTypeFields\n");
        return;
    }

    int i = 0;
    while ((i < reply.SizeOfArray(L"requestTypeFields"))) {
        reply.put_I(i);
        wprintf(L"%s  %s  Required: %d\n",reply.stringOf(L"requestTypeFields[i].fieldId"),reply.stringOf(L"requestTypeFields[i].name"),reply.BoolOf(L"requestTypeFields[i].required"));
        i = i + 1;
    }

    //  Includes validValues and field schemas for constructing the request.
    wprintf(L"%s\n",reply.emit());
    wprintf(L"Service desk ID: %s  Request type ID: %s\n",serviceDeskId,requestTypeId);
    }