Stream

Live and recorded video streaming over HLS. Request the playlist for a device camera channel, then fetch the referenced .ts segments. These endpoints return raw playlists and video segments rather than JSON.

GET/stream/{deviceId}/{channel}/live.m3u8

Fetch the HLS playlist for a Device camera channel

Authorizations

BasicAuth or ApiKey

  • Name
    BasicAuth
    Type
    scheme
    Description
    HTTP Authorization Scheme: basic
  • Name
    ApiKey
    Type
    scheme
    Description
    HTTP Authorization Scheme: bearer

Path parameters

  • Name
    deviceId
    Type
    integer required
    Description
  • Name
    channel
    Type
    integer required
    Description

Response schema

  • Name
    application/json
    Type
    schema
    Description

Responses

  • Name
    200
    Type
    success
    Description
    OK
  • Name
    401
    Type
    error
    Description
    Unauthorized

Request

GET
/stream/{deviceId}/{channel}/live.m3u8
curl --location 'https://gw.onemap8.com/api/stream/<integer>/<integer>/live.m3u8' \
--header 'Accept: application/json' \
--header 'Authorization: Basic {your_access_token}'

Response

"<string>"

GET/stream/{deviceId}/{channel}/{index}.ts

Fetch an HLS video segment for a Device camera channel

Authorizations

BasicAuth or ApiKey

  • Name
    BasicAuth
    Type
    scheme
    Description
    HTTP Authorization Scheme: basic
  • Name
    ApiKey
    Type
    scheme
    Description
    HTTP Authorization Scheme: bearer

Path parameters

  • Name
    deviceId
    Type
    integer required
    Description
  • Name
    channel
    Type
    integer required
    Description
  • Name
    index
    Type
    integer required
    Description

Response schema

  • Name
    application/json
    Type
    schema
    Description

Responses

  • Name
    200
    Type
    success
    Description
    OK
  • Name
    401
    Type
    error
    Description
    Unauthorized

Request

GET
/stream/{deviceId}/{channel}/{index}.ts
curl --location 'https://gw.onemap8.com/api/stream/<integer>/<integer>/<integer>.ts' \
--header 'Accept: application/json' \
--header 'Authorization: Basic {your_access_token}'

Response

"<binary>"

GET/stream/{deviceId}/{channel}/playback.m3u8

Fetch the HLS playlist for a Device camera remote playback session

Serves recorded video streamed by the device after a videoPlayback command. Buffered independently from the live stream of the same channel.

Authorizations

BasicAuth or ApiKey

  • Name
    BasicAuth
    Type
    scheme
    Description
    HTTP Authorization Scheme: basic
  • Name
    ApiKey
    Type
    scheme
    Description
    HTTP Authorization Scheme: bearer

Path parameters

  • Name
    deviceId
    Type
    integer required
    Description
  • Name
    channel
    Type
    integer required
    Description

Response schema

  • Name
    application/json
    Type
    schema
    Description

Responses

  • Name
    200
    Type
    success
    Description
    OK
  • Name
    401
    Type
    error
    Description
    Unauthorized

Request

GET
/stream/{deviceId}/{channel}/playback.m3u8
curl --location 'https://gw.onemap8.com/api/stream/<integer>/<integer>/playback.m3u8' \
--header 'Accept: application/json' \
--header 'Authorization: Basic {your_access_token}'

Response

"<string>"

GET/stream/{deviceId}/{channel}/playback/{index}.ts

Fetch an HLS video segment for a Device camera remote playback session

Authorizations

BasicAuth or ApiKey

  • Name
    BasicAuth
    Type
    scheme
    Description
    HTTP Authorization Scheme: basic
  • Name
    ApiKey
    Type
    scheme
    Description
    HTTP Authorization Scheme: bearer

Path parameters

  • Name
    deviceId
    Type
    integer required
    Description
  • Name
    channel
    Type
    integer required
    Description
  • Name
    index
    Type
    integer required
    Description

Response schema

  • Name
    application/json
    Type
    schema
    Description

Responses

  • Name
    200
    Type
    success
    Description
    OK
  • Name
    401
    Type
    error
    Description
    Unauthorized

Request

GET
/stream/{deviceId}/{channel}/playback/{index}.ts
curl --location 'https://gw.onemap8.com/api/stream/<integer>/<integer>/playback/<integer>.ts' \
--header 'Accept: application/json' \
--header 'Authorization: Basic {your_access_token}'

Response

"<binary>"