Developer Resources

API / (GET) Show Links

This API call returns a list of links.

API URL
https://youraccount.beetil.com/external_api/v1/links/:beetil_type/:beetil_id.format
HTTP Method
GET




URL parameters

ParameterFormatDefaultMandatory
beetil_typeThe name of the beetil (see points of interest).stringYes
beetil_idThe reference number of the beetil (see points of interest).integerYes




Points of Interest
  • The beetil_type is always plural. (e.g. incidents)
  • Possible beetil types are: incidents, changes, problems and releases.
  • Example uri: /external_api/v1/links/incidents/123
    Example uri: /external_api/v1/links/changes/123
    Example uri: /external_api/v1/links/problems/123
    Example uri: /external_api/v1/links/releases/123




Example JSON Response
{
  "result": {
    "releases": [
      {
        "release_link": "/external_api/v1/links/incidents/33/releases/265",
        "release_id": 265
      }
    ],
    "incidents": [
      {
        "incident_link": "/external_api/v1/links/incidents/33/incidents/1234",
        "incident_id": 1234
      },
      {
        "incident_link": "/external_api/v1/links/incidents/33/incidents/678",
        "incident_id": 789
      }
    ],
    "changes": [

    ],
    "problems": [
      {
        "problem_id": 164,
        "problem_link": "/external_api/v1/links/incidents/33/problems/164"
      },
      {
        "problem_id": 165,
        "problem_link": "/external_api/v1/links/incidents/33/problems/165"
      },
      {
        "problem_id": 166,
        "problem_link": "/external_api/v1/links/incidents/33/problems/166"
      }
    ]
  },
  "version": "1.0",
  "status": "Success"
}




Last updated 31 January 2011