Pular navegação
Base de conhecimento

Restreams

Crie e gerencie restreams.

Restreams

Criar retransmissão

POST {{baseHost}}/v2/live/events/:event_id/restreams

Adiciona ao evento um destino RTMP de retransmissão — a transmissão ao vivo será espelhada nele.

Request body (json)
{  "name": "Restream name",  "url": "rtmp://rtmp.kinescope.io/live",  "key": "stream key",  "description": "Description",  "enabled": true}
Responses
{    "data": {        "id": "<UUID>",        "event_id": "<UUID>",        "name": "Restream name",        "url": "rtmp://rtmp.kinescope.io/live",        "key": "stream key",        "status": "disconnected",        "enabled": true,        "description": "Description",        "created_at": "2022-11-15T12:50:33.867315Z",        "updated_at": null    }}{    "data": {        "id": "<UUID>",        "event_id": "<UUID>",        "name": "Restream name",        "url": "rtmp://rtmp.kinescope.dev/live",        "key": "stream key",        "status": "disconnected",        "enabled": true,        "description": "Description",        "created_at": "2022-11-15T12:50:33.867315Z",        "updated_at": null    }}

Atualizar retransmissão

PUT {{baseHost}}/v2/live/events/:event_id/restreams/:restream_id

Atualiza um destino de retransmissão (URL, chave de transmissão, ativação).

Request body (json)
{  "name": "Restream name 1",  "url": "rtmp://rtmp.kinescope.io/live",  "key": "stream key",  "description": "Description",  "enabled": true}
Responses
{    "data": {        "id": "<UUID>",        "event_id": "<UUID>",        "name": "Restream name 1",        "url": "rtmp://rtmp.kinescope.io/live",        "key": "stream key",        "status": "disconnected",        "enabled": true,        "description": "Description",        "created_at": "2022-11-15T12:50:33.867315Z",        "updated_at": "2022-11-15T12:51:28.175339Z"    }}{    "data": {        "id": "<UUID>",        "event_id": "<UUID>",        "name": "Restream name 1",        "url": "rtmp://rtmp.kinescope.dev/live",        "key": "stream key",        "status": "disconnected",        "enabled": true,        "description": "Description",        "created_at": "2022-11-15T12:50:33.867315Z",        "updated_at": "2022-11-15T12:51:28.175339Z"    }}

Obter retransmissão

GET {{baseHost}}/v2/live/events/:event_id/restreams/:restream_id

Retorna os dados de uma retransmissão pelo seu identificador único.

Responses
{  "data": {    "id": "<UUID>",    "event_id": "<UUID>",    "name": "23234",    "url": "rtmp://rtmp.kinescope.io/live",    "key": "23234234",    "status": "disconnected",    "enabled": false,    "description": "",    "created_at": "2026-03-03T10:55:22.991595Z",    "updated_at": "2026-03-03T11:10:05.345611Z"  }}

Listar retransmissões

GET {{baseHost}}/v2/live/events/:event_id/restreams/:restream_id

Retorna a lista de retransmissões. Os resultados são paginados e podem ser filtrados por parâmetros de consulta.

Responses
{  "data": {    "id": "<UUID>",    "event_id": "<UUID>",    "name": "23234",    "url": "rtmp://rtmp.kinescope.io/live",    "key": "23234234",    "status": "disconnected",    "enabled": false,    "description": "",    "created_at": "2026-03-03T10:55:22.991595Z",    "updated_at": "2026-03-03T11:10:05.345611Z"  }}

Excluir retransmissão

DELETE {{baseHost}}/v2/live/events/:event_id/restreams/:restream_id

Exclui a retransmissão permanentemente. A ação não pode ser desfeita.