Feed de alterações

GEThttps://livetp.app/api/v1/scripts

O feed é a forma recomendada de manter uma cópia local da biblioteca. Cada item traz um cursor e o roteiro completo como ficou depois da gravação. Com cursor=0, o feed funciona como download inicial; nas chamadas seguintes, retorna só as novidades. Requer o escopo scripts:read.

O cursor é transacional: mesmo com gravações concorrentes, você nunca pula uma alteração confirmada ao avançar o cursor.

Parâmetros de query

cursorstringquerypadrão: "0"

Posição no feed. Comece com 0 e depois use o nextCursor recebido. Inteiro em texto, com até 19 dígitos.

limitintegerquerypadrão: 100

Itens por página, de 1 a 200.

Resposta

changesobject[]

Alterações em ordem crescente de cursor.

Mostrar propriedades

cursorstring

Posição desta alteração no feed.

scriptobject

Estado completo do roteiro após a gravação. Na lixeira, deletedAt vem preenchido.

nextCursorstring

Cursor para a próxima chamada. Se não houver novidades, repete o cursor enviado.

hasMoreboolean

true se houver mais alterações disponíveis agora.

Como aplicar

Processe os itens em ordem.
Faça upsert pelo script.id: a última ocorrência de um roteiro vence.
Trate deletedAt preenchido como lixeira, não como exclusão definitiva.
Guarde nextCursor só depois de aplicar a página.

Requisição

curl 'https://livetp.app/api/v1/scripts?cursor=0&limit=100' \
  -H "Authorization: Bearer $LIVETP_API_KEY"

Resposta

{
  "changes": [
    {
      "cursor": "41",
      "script": {
        "id": "67a92051-1245-4126-b9b4-2c532084ae16",
        "title": "Lançamento do produto",
        "content": "Olá! Hoje vou mostrar três novidades...",
        "status": "ready",
        "revision": 5,
        "createdAt": "2026-10-30T15:00:00.120408+00:00",
        "updatedAt": "2026-10-30T15:50:31.004512+00:00",
        "deletedAt": null
      }
    },
    {
      "cursor": "42",
      "script": {
        "id": "0c9b5e8a-4f1d-4b6e-a2c3-7d8e9f0a1b2c",
        "title": "Rascunho antigo",
        "content": "",
        "status": "draft",
        "revision": 3,
        "createdAt": "2026-10-20T09:00:00.551203+00:00",
        "updatedAt": "2026-10-30T16:10:02.441876+00:00",
        "deletedAt": "2026-10-30T16:10:02.441876+00:00"
      }
    }
  ],
  "nextCursor": "42",
  "hasMore": false
}

As datas dos itens do feed vêm do histórico gravado no banco e podem ter precisão de microssegundos e fuso +00:00 em vez de Z. Ambos os formatos são ISO 8601 válidos: use um parser de datas, não comparação de texto.

Feed de alterações

Parâmetros de queryCopiar link da seção

RespostaCopiar link da seção

Como aplicarCopiar link da seção

Parâmetros de query

Resposta

Como aplicar