Skip to content

API OPS: getdevices

OPS: Get Devices

This API call will list all the devices managed by the showrunner server. This is equivalent to the list of devices assigned to the onboard area that is assigned to the show(s) managed by the showrunner.

The call accepts an optional query string "state" which represents the device state to filter the response by. If multiple states are listed in a comma separated list, they are treated as an "OR" list where any of those states will be acceptable.

** Note: showrunner must be used for this

Endpoint:

    /api/v1/ops/getdevices
    /api/v1/ops/getdevices?state=InExperience
    /api/v1/ops/getdevices?state=Onboard,InExperience

Verb: GET

Payload:

Type Attribute Required Description
number show_id Yes Unique ID for corresponding show

Example Response:

{
    "devices": [
        {
            "id": 1,
            "mac_address": "DevOA1_1",
            "scan_id": "ScanOA1_1",
            "type": "PC",
            "version": "GemTest",
            "onboard_area_id": 2,
            "state": 0,
            "gem_user_id": 1,
            "gem_show_id": 0,
            "last_scan": "0000-12-31T16:07:02-07:52",
            "last_contact": "0000-12-31T16:07:02-07:52"
        },
        {
            "id": 2,
            "mac_address": "DevOA1_2",
            "scan_id": "ScanOA1_2",
            "type": "PC",
            "version": "GemTest",
            "onboard_area_id": 2,
            "state": 0,
            "gem_user_id": 1,
            "gem_show_id": 0,
            "last_scan": "0000-12-31T16:07:02-07:52",
            "last_contact": "0000-12-31T16:07:02-07:52"
        }
    ],
    "api_code": 0,
    "error": null
}