Caso de uso

Transforme qualquer script em um endpoint de API

Escreva uma função main, publique e ligue o endpoint. Outro sistema envia uma requisição, o script roda com os valores dela como entradas e a resposta traz a saída.

Os parâmetros são a API

Os argumentos do main viram as entradas do endpoint, com os seus tipos. Um valor ausente ou do tipo errado é recusado com 422 antes de qualquer execução começar.

Saiba mais →
monthly_close.py
def main(month: str, dry_run: bool = False):
    total = 1250.75  # your calculation here
    return {'month': month, 'total': total, 'dryRun': dry_run}

Síncrono ou assíncrono, você escolhe

Uma chamada síncrona espera até 30 segundos e devolve a saída. Uma chamada assíncrona responde 202 com um runId na hora, e você consulta até a execução terminar.

Saiba mais →
call.sh
curl -X POST "https://<your-waiso-address>/exec/<project-id>/monthly-close" \
  -H "Authorization: Bearer $WAISO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"month": "2026-09"}'

Tokens, limites e o registro de cada chamada

Cada token alcança só os endpoints que você marcar e pode expirar. Defina chamadas por minuto em cada endpoint e abra qualquer execução para ver a requisição exata que ela recebeu.

Perguntas

Um flow também pode ser um endpoint de API?

Sim. Todo script, flow ou robô do AI Scraper publicado pode ter um endpoint HTTP; um flow recebe os valores como entradas do Início.

O que acontece se uma chamada síncrona passar de 30 segundos?

A chamada responde 504 e a execução continua; busque o resultado depois pelo runId.

Posso mandar parâmetros na query string em vez de JSON?

Sim. Mude o endpoint para Query string e os valores chegam nos tipos que o seu script declara.

Posso compartilhar a documentação dos meus endpoints?

Sim. A página API publica uma documentação em que quem chama pode ler e testar os endpoints do projeto.

Veja também

Comece hoje

Pronto para rodar seus scripts?

Crie sua conta em segundos — sem instalar nada, sem configurar nada.
Comece a construir, testar e rodar seus scripts na hora.

  • Comece de graça
  • Sua infra ou nuvem
  • Pronto para produção