API da plataforma e tokens de acesso

Uma API, três entradas

O escopo vale por projeto e por área. Um token em Editar em Scripts e Ler em Execuções pode atualizar um script e listar execuções, e nada mais; o mesmo token num projeto que não recebeu responde como se o projeto não existisse. E, diga o que disser o escopo, o token também é limitado pelo que o dono pode fazer agora: se um admin reduz o acesso do dono, todos os tokens dessa pessoa se estreitam na hora.

Crie um token de acesso

1. 1
   Abra Tokens de acesso

   Abra Configurações → Tokens de acesso e clique em Novo token.

2. 2
   Escolha o que ele alcança

   Ligue cada projeto que ele pode alcançar, em Ler, Editar ou Excluir — ou abra Personalizar áreas para dar a cada área (Scripts, Flows, Execuções, Agendamentos…) o próprio nível, ou nenhum.

3. 3
   Defina quando expira

   Escolha uma validade, ou nunca. Ele aparece uma vez: copie agora. A lista depois mostra os primeiros caracteres, quando foi usado por último e quantas chamadas fez.

Revogue um token na mesma lista: a próxima chamada com ele é recusada. Admins veem todos os tokens do workspace em Todos os tokens.

Chame por HTTP

curl -H "Authorization: Bearer $WAISO_TOKEN" \
  "https://waiso.dev/api/projects/$PROJECT_ID/runs?status=failed&limit=5"

As mesmas chamadas dentro de um script

Num script, waiso.api não precisa de token nem de endereço: age como quem iniciou a execução (o dono do projeto em agendamentos e endpoints), e uma chamada que não diz o projeto age no do próprio script.

import waiso

def main():
    failed = waiso.api.runs.list(status="failed", limit=20)["items"]
    for run in failed:
        waiso.api.runs.cancel(run["id"]) if run["status"] == "running" else None
    return {"failed": len(failed)}