Jump to

• Request
• Response

Get hazard details

get

/connectedWorker/clientapi/v2/projects/{projectId}/hazards/{hazardId}

This operation retrieves the details of a specific hazard.

Request

Path Parameters

• hazardId: integer(int64)
  Hazard identifier
• projectId: integer(int64)
  Project identifier

Back to Top

Response

Supported Media Types

• application/json

200 Response

Hazard was successfully retrieved

Body ()

Root Schema : Hazard

Type: object

Show Source

• action: string
  Minimum Length: 0

  Maximum Length: 255

  Action that must be taken, cannot be blank, max length is 255 characters

  Example: Evacuate immediately
• created(optional): string(date-time)
  Read Only: true

  Hazard creation time in ISO-8601 format

  Example: 2018-01-01T11:59:59
• id(optional): integer(int64)
  Read Only: true

  The unique id of the object

  Example: 53
• links(optional): array links
• locationIds: array locationIds
  Locations affected by the hazard, cannot be empty
• message(optional): string
  Optional message describing the hazard details

  Example: This is detailed message describing hazard in more detail
• severity: string
  Allowed Values: [ "hazard.severity.low", "hazard.severity.medium", "hazard.severity.high" ]

  Severity of the hazard

  Example: hazard.severity.medium
• severityValue(optional): string
  Read Only: true

  Configurable text interpretation of the severity

  Example: Configured severity value
• status(optional): string
  Read Only: true

  Allowed Values: [ "OPEN", "RESOLVED" ]

  Status of the hazard

  Example: OPEN
• subject: string
  Minimum Length: 0

  Maximum Length: 255

  Subject of the hazard, cannot be blank, max length is 255 characters

  Example: Gas leak

{
    "type":"object",
    "required":[
        "action",
        "locationIds",
        "severity",
        "subject"
    ],
    "properties":{
        "id":{
            "type":"integer",
            "format":"int64",
            "example":53,
            "description":"The unique id of the object",
            "readOnly":true
        },
        "severity":{
            "type":"string",
            "example":"hazard.severity.medium",
            "description":"Severity of the hazard",
            "enum":[
                "hazard.severity.low",
                "hazard.severity.medium",
                "hazard.severity.high"
            ]
        },
        "severityValue":{
            "type":"string",
            "example":"Configured severity value",
            "description":"Configurable text interpretation of the severity",
            "readOnly":true
        },
        "subject":{
            "type":"string",
            "example":"Gas leak",
            "description":"Subject of the hazard, cannot be blank, max length is 255 characters",
            "minLength":0,
            "maxLength":255
        },
        "action":{
            "type":"string",
            "example":"Evacuate immediately",
            "description":"Action that must be taken, cannot be blank, max length is 255 characters",
            "minLength":0,
            "maxLength":255
        },
        "message":{
            "type":"string",
            "example":"This is detailed message describing hazard in more detail",
            "description":"Optional message describing the hazard details"
        },
        "created":{
            "type":"string",
            "format":"date-time",
            "example":"2018-01-01T11:59:59",
            "description":"Hazard creation time in ISO-8601 format",
            "readOnly":true
        },
        "status":{
            "type":"string",
            "example":"OPEN",
            "description":"Status of the hazard",
            "readOnly":true,
            "enum":[
                "OPEN",
                "RESOLVED"
            ]
        },
        "locationIds":{
            "type":"array",
            "example":"[51, 52]",
            "description":"Locations affected by the hazard, cannot be empty",
            "items":{
                "type":"integer",
                "format":"int64"
            }
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : locationIds

Type: array

Locations affected by the hazard, cannot be empty

Show Source

• Array of: integer(int64)

{
    "type":"array",
    "example":"[51, 52]",
    "description":"Locations affected by the hazard, cannot be empty",
    "items":{
        "type":"integer",
        "format":"int64"
    }
}

Example:

[51, 52]

Nested Schema : Link

Type: object

Show Source

• href: string
  The target resource's URI
• rel: string
  Relation type

{
    "type":"object",
    "required":[
        "href",
        "rel"
    ],
    "properties":{
        "rel":{
            "type":"string",
            "description":"Relation type"
        },
        "href":{
            "type":"string",
            "description":"The target resource's URI"
        }
    }
}

Back to Top