Referência do SDK

Esta página reúne os recursos usados pelos scripts deste projeto. Para o funcionamento geral das automações, veja a visão geral.

Filtros com Filter

Um filtro recebe três argumentos: o campo, o valor e o operador.

Filter("id_externo", "123456", "==")
Filter("checkin", "2026-03-01", ">=")

Operadores aceitos como texto: ==, !=, >, <, >=, <= e LIKE.

Datas

Datas no formato AAAA-MM-DD podem ser comparadas diretamente como texto com <= e >=, pois a ordem alfabética coincide com a ordem cronológica. Os scripts de pagamentos e bloqueios dependem disso.

Os valores também podem ser booleanos, como em Filter("calculado", False, "=="), ou inteiros, como em Filter("id_gpt5kqvv_uamuvwmxj9rm", 73, "==").

Consultas: get()

registros = jestor.table("4t52yq48kfmfe5lcnhmgv").get([
    Filter("id_externo", "abc123", "==")
], 1000)

• O primeiro argumento é a lista de filtros. Uma lista vazia ([]) traz todos os registros.
• O segundo argumento é o limite de registros. Os scripts usam 1, 20, 200 e 1000 conforme o caso.
• O retorno é uma lista de dicionários. Verifique se a lista está vazia antes de acessar [0].

Limite de registros

Consultas sem paginação param no limite informado. Se a tabela tiver mais registros que isso, o resultado fica incompleto. Os scripts de bloqueios e pagamentos usam 1000 e não paginam, então o problema pode aparecer com o crescimento dos dados.

Inserção: insert()

novo = jestor.table("vhwynb8ysthr3u1a6xc05").insert({
    "name": "Booking.com",
    "id_externo": "partner-789"
})

Retorna o registro criado. Use o campo de ID interno (id_<slug>) do retorno para vincular outros registros.

Atualização: update()

jestor.table("pfziere4qayrb1ui_4bv4").update("447", {
    "bloqueio_ativo": True
})

O primeiro argumento é o ID do registro, e o segundo é um dicionário apenas com os campos a alterar.

Loops

Em um trigger After na mesma tabela, um update() pode disparar o próprio trigger de novo. Compare o valor atual antes de gravar, como em if data.get("campo") != novo_valor:.

Exclusão: delete()

jestor.table("sd_nha4mb5yb_3npz_m2b").delete(registro["id_sd_nha4mb5yb_3npz_m2b"])

A exclusão é definitiva. Passe o ID interno do registro, não o ID externo.

Requisições HTTP: post() e get()

Chamadas HTTP pelo SDK recebem uma lista única de parâmetros:

resposta = jestor.post([url, headers, body])
resposta = jestor.get([url, headers])

Os scripts deste projeto, porém, chamam a Stays com a biblioteca requests, que retorna o objeto de resposta com status_code, json() e text. Use timeout em todas as chamadas.

Interface

Função	Uso
stopCodeExecution("mensagem")	Interrompe a execução. Em Before, cancela a gravação e mostra um popup vermelho. Em rotinas e After, apenas encerra.
showMessage("texto", Type.SUCCESS)	Mostra um aviso flutuante. Tipos: SUCCESS, ERROR, WARNING, INFO.
response({...})	Devolve um dicionário ao botão que disparou a função. Usado na sincronização manual.

Note

response() aparece no script de sincronização manual, mas não está descrito no guia de referência. Confirme o comportamento no painel antes de depender do retorno.

Variáveis de entrada

Variável	Disponível em	Conteúdo
event	Triggers	Dicionário com before_save, current_data, after_save, current_user, org e outros
params	Webhooks	Dicionário com action e payload
recordData	Funções (botões)	Registro da linha onde o botão foi clicado

Nos scripts de função, o registro chega diretamente como recordData. O guia menciona também event['record_data'], então confirme qual forma se aplica ao seu caso.