Pular navegação
Base de conhecimento

Restreams

Crie e gerencie restreams.

Restreams

Criar retransmissão

POST https://api.kinescope.io/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
    }
}

Obter retransmissão

GET https://api.kinescope.io/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 https://api.kinescope.io/v2/live/events/:event_id/restreams

Retorna todos os destinos de retransmissão do evento. A resposta é um array simples — este endpoint não tem paginação nem meta.

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"
    }
  ]
}

Atualizar retransmissão

PUT https://api.kinescope.io/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"
    }
}

Excluir retransmissão

DELETE https://api.kinescope.io/v2/live/events/:event_id/restreams/:restream_id

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