Sample code for 30+ languages & platforms
Visual FoxPro Requires Chilkat v11.0.0+

Jira Cloud: Create a Customer Request

See more Jira Examples

Create a Jira Service Management customer request using a service desk ID, request type ID, and the fields accepted by that portal form. Use request type discovery first. This example assumes summary and description are available and supplies them as strings in requestFieldValues; this is not the platform v3 ADF request format.

Add every additional required field using the schema and valid values returned by request type discovery. The authenticated account must be permitted to create requests in the service desk. Omitting raiseOnBehalfOf creates the request as that account. A successful request creates a real ticket and may send notifications; check for an existing ticket before retrying after an uncertain network outcome.

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 Visual FoxPro Downloads

Visual FoxPro
LOCAL lnSuccess
LOCAL loHttp
LOCAL lcBaseUrl
LOCAL loUrl
LOCAL loResp
LOCAL loReply
LOCAL loRequest

lnSuccess = 0

*  Assumes Chilkat is unlocked. See Global Unlock Sample.

loHttp = CreateObject('Chilkat.Http')
loHttp.RequireSslCertVerify = 1
loHttp.BasicAuth = 1
*  Read these credentials from private application configuration.
loHttp.Login = "YOUR_ATLASSIAN_EMAIL"
loHttp.Password = "YOUR_API_TOKEN"
lcBaseUrl = "https://your-domain.atlassian.net"
loHttp.Accept = "application/json"
loUrl = CreateObject('Chilkat.StringBuilder')
loResp = CreateObject('Chilkat.HttpResponse')
loReply = CreateObject('Chilkat.JsonObject')
loRequest = CreateObject('Chilkat.JsonObject')
loRequest.UpdateString("serviceDeskId","YOUR_SERVICE_DESK_ID")
loRequest.UpdateString("requestTypeId","YOUR_REQUEST_TYPE_ID")
loRequest.UpdateString("requestFieldValues.summary","Example customer request")
loRequest.UpdateString("requestFieldValues.description","Details of the request.")
loUrl.SetString(lcBaseUrl)
loUrl.Append("/rest/servicedeskapi/request")
lnSuccess = loHttp.HttpJson("POST",loUrl.GetAsString(),loRequest,"application/json",loResp)
IF (loResp.StatusCode = 0) THEN
    ? "No HTTP response was received. Check connectivity and TLS settings."
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    RELEASE loRequest
    CANCEL
ENDIF

IF ((lnSuccess <> 1) OR (loResp.StatusCode < 200) OR (loResp.StatusCode >= 300)) THEN
    ? "Request failed. HTTP " + STR(loResp.StatusCode)
    IF (loResp.StatusCode = 429) THEN
        ? "Rate limited. Retry-After: " + loResp.GetHeaderField("Retry-After")
    ENDIF

    *  Inspect this response locally; it can contain private Jira data.
    ? loResp.BodyStr
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    RELEASE loRequest
    CANCEL
ENDIF

lnSuccess = loReply.Load(loResp.BodyStr)
IF (lnSuccess <> 1) THEN
    ? "Expected a JSON object in the response."
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    RELEASE loRequest
    CANCEL
ENDIF

IF ((loReply.JsonTypeOf("issueKey") <> 1) OR (loReply.StringOfEquals("issueKey","",1) = 1)) THEN
    ? "Missing value: issueKey"
    RELEASE loHttp
    RELEASE loUrl
    RELEASE loResp
    RELEASE loReply
    RELEASE loRequest
    CANCEL
ENDIF

? "Request: " + loReply.StringOf("issueKey")
? "Status: " + loReply.StringOf("currentStatus.status")
? "Portal URL: " + loReply.StringOf("_links.web")

RELEASE loHttp
RELEASE loUrl
RELEASE loResp
RELEASE loReply
RELEASE loRequest