You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 26 Next »

Integration API is available at slaapp.almarise.com

Find out how to identify the Jira Issue ID in Cloud

This API is dedicated to integration between Jira and third-party systems and allows for the extraction of data such as SLA metic state, history, etc.

Basic authentication is used to authenticate calls (email address + security token). Read how to set up a personal access token as described here.

Request headers to be set:

  • Source-System - JIRA

  • Jira-Host - address of Jira Cloud instance

Endpoints

  • SLA Metric State
GET/integration/V1/metrics-state/{ticketId}

This endpoint allows viewing the states of all SLA metrics in the given issue.

ParameterTypeDefault valueRequired
ticketIdstring
     check mark 
showUiMetaDatabooleanfalse

Request URL: https://slaapp.almarise.com/integration/V1/metrics-state/10039?showUiMetaData=false

Response body:

[
    {
        "slaMetricId": "6729eb08a66f5026ea86fbd1",
        "ticketId": "10039",
        "slaMetricState": "ACTIVE",
        "deadline": "2024-12-05T11:32:19.893+01:00",
        "timeSpent": {
            "millis": 30758956,
            "shortText": "8h 32m 38s"
        },
        "timeRemaining": {
            "millis": -19958956,
            "shortText": "-5h 32m 38s"
        },
        "totalTime": {
            "millis": 10800000,
            "shortText": "3h"
        },
        "isBreached": true,
        "flowingDeadline": false,
        "wasRestarted": false,
        "metricName": "SLA metric 1.0",
        "visible": true
    },
    {
        "slaMetricId": "6751a9af00835a31fb1c27ac",
        "ticketId": "10039",
        "slaMetricState": "ACTIVE",
        "deadline": "2024-12-05T11:32:19.893+01:00",
        "timeSpent": {
            "millis": 30758956,
            "shortText": "8h 32m 38s"
        },
        "timeRemaining": {
            "millis": -19958956,
            "shortText": "-5h 32m 38s"
        },
        "totalTime": {
            "millis": 10800000,
            "shortText": "3h"
        },
        "isBreached": true,
        "flowingDeadline": false,
        "wasRestarted": false,
        "metricName": "Time To Resolution",
        "visible": true
    }
]


GET/integration/V1/metrics-state/{ticketId}/metrics

This endpoint returns metrics related to the given issue.

ParameterTypeDefault valueRequired
ticketIdstring
     check mark 
showHiddenbooleanfalse

Request URL: https://slaapp.almarise.com/integration/V1/metrics-state/10039/metrics?showHidden=true

Response body:

[
  {
    "name": "SLA metric 1.0",
    "id": "6729eb08a66f5026ea86fbd1",
    "visible": true
  },
  {
    "name": "Time To Resolution",
    "id": "6751a9af00835a31fb1c27ac",
    "visible": true
  }
]
GET/integration/V1/metrics-state/{ticketId}/{slaMetricId}

Returns the state of requested SLA metrics in the given issue.

ParameterTypeDefault valueRequired
ticketIdstring
     check mark 
slaMetricIdstring
check mark 
showUiMetaDatabooleanfalse

Request URL: https://slaapp.almarise.com/integration/V1/metrics-state/10039/6751a9af00835a31fb1c27ac?showUiMetaData=false

Response body:

{
  "slaMetricId": "6751a9af00835a31fb1c27ac",
  "ticketId": "10039",
  "slaMetricState": "ACTIVE",
  "deadline": "2024-12-05T11:32:19.893+01:00",
  "timeSpent": {
    "millis": 32581835,
    "shortText": "9h 3m 1s"
  },
  "timeRemaining": {
    "millis": -21781835,
    "shortText": "-6h 3m 1s"
  },
  "totalTime": {
    "millis": 10800000,
    "shortText": "3h"
  },
  "isBreached": true,
  "flowingDeadline": false,
  "wasRestarted": false,
  "metricName": "Time To Resolution",
  "visible": true
}
 

Responses


  • No labels