Skip to content

Service Integration

Service Integration allows creation automation that creates events in StatusHub from various 3rd party applications.
As opposed to StatusHub Management API, those integrations endpoints are simplified and doesn't allow reading any data.
Most of integrations use per-service token for authorization.

Operations

List service integrations

Request

List all of available integrations for a service.
Integration version is used to indicate the generation of integrations where v1 are the basic integrations available in StatusHub for long time. while v2 integrations are much more capable and all newly introduced integrations will be added in v2 version.

Security
ApiKeyAuth
Path
subdomainstringrequired

Unique subdomain of requested Hub.

service_idinteger, >= 1required

id of the service

Query
enabledboolean

Filter by enabled status

versionstring

Filter by integration version.
Currently available versions:

  • v1 - basic integrations available in StatusHub for long time,
  • v2 - more capable integrations. All newly introduced integrations will be added in v2 version.
Enum:"v1""v2"
api_versionstring

Api version

Value:"V3-R1"
curl -i -X GET \
  'https://subdomain-of-your-account.app.statushub.io/api/v3/hubs/{subdomain}/services/{service_id}/integrations?enabled=true&version=v1&api_version=V3-R1' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
current_pageinteger, >= 1
Example:1
page_countinteger, >= 1
Example:4
per_pageinteger, [ 1 .. 100 ]
Example:25
totalinteger, >= 0
Example:1024
dataArray of objects
Response
{
  "current_page": 1,
  "page_count": 4,
  "per_page": 25,
  "total": 1024,
  "data": [
    { … }
  ]
}