# Conheça os Analysis Endpoints

> Com Analysis Endpoints, scripts Luau respondem a requisições HTTP com JSON, HTML, CSV ou texto. Teste no Admin e use em Custom Dashboards e no TagoRUN.

![Conheça os Analysis Endpoints](https://tago.io/og/pt-br/blog/introducing-analysis-endpoints.png)

Uma Analysis já pode processar seus dados. Com Analysis Endpoints, ela também pode responder à aplicação que a chamou. Dê a uma Analysis em Luau sua própria URL HTTP, envie uma requisição e receba o resultado do script na mesma chamada.

Um formulário de dashboard pode verificar se uma configuração de temperatura é válida antes de salvá-la. Um dispositivo pode buscar sua configuração, ou outro serviço pode enviar um webhook e receber uma confirmação. Essa lógica de requisição e resposta fica dentro da TagoIO, junto dos dados dos seus dispositivos e das regras de acesso, sem um serviço web separado para colocar no ar.

## Sua Analysis, com uma URL própria

![Uma Analysis em Luau com sua própria URL HTTP, acesso Public ou Token e respostas em JSON, CSV, HTML ou redirecionamento](https://tago.io/images/blog/introducing-analysis-endpoints/endpoint.svg)

Retorne JSON para um dispositivo, envie uma exportação CSV para uma planilha ou sirva uma página HTML. Seu script controla a resposta, incluindo redirecionamentos.

Use o acesso Public para requisições sem token ou o acesso Token para chamadas autenticadas. O [Access Management](https://docs.tago.io/docs/tagoio/analysis/endpoints/using-endpoints#choose-who-can-call) controla quais usuários do Run e quais Analysis podem chamar seu código. Seu script pode usar a identidade de quem fez a chamada para decidir o que retornar.

## Mostre a resposta no seu dashboard

![Um ajuste de temperatura de 50 °C no dashboard é rejeitado: a Analysis retorna um erro de campo, o formulário mostra a faixa permitida de 5 a 30 e nada é salvo](https://tago.io/images/blog/introducing-analysis-endpoints/dashboard-validation.svg)

Os Custom Dashboards no Admin e no TagoRUN chamam Endpoints com a sessão de quem está visualizando o dashboard. Não é preciso inserir um token no HTML do dashboard.

Rejeite uma configuração de termostato fora da faixa permitida e mostre o erro ao lado do campo antes de salvar qualquer dado. O [exemplo de validação de dashboard](https://docs.tago.io/docs/tagoio/analysis/endpoints/recipes/validate-dashboard-form) mostra como conectar o formulário à sua Analysis.

## Receba webhooks e crie middleware

![Um serviço de meteorologia envia 23,5 °C e 64% de umidade a uma Analysis em Luau, que valida a entrada, converte a temperatura para 74,3 °F, salva as leituras e retorna uma confirmação na mesma chamada](https://tago.io/images/blog/introducing-analysis-endpoints/webhook-flow.svg)

Receba eventos de sistemas externos sem colocar um servidor de webhooks no ar. Um serviço de meteorologia, por exemplo, pode enviar temperatura e umidade em uma única requisição. Sua Analysis pode validar as leituras, converter Celsius para Fahrenheit, salvar os resultados no dispositivo correspondente e retornar uma confirmação.

Use um Endpoint como middleware quando outra aplicação enviar um formato de dados diferente ou esperar uma resposta personalizada. Seu script pode validar e transformar a entrada, trabalhar com recursos da TagoIO e retornar o formato de que a aplicação precisa. O [exemplo de webhook](https://docs.tago.io/docs/tagoio/analysis/endpoints/recipes/receive-webhook) inclui um receptor completo.

## Publique um formulário sem hospedar um site

![Um formulário de feedback servido por um Endpoint envia uma mensagem, salva-a nos dados de um dispositivo e recebe uma página de agradecimento](https://tago.io/images/blog/introducing-analysis-endpoints/feedback-form.svg)

Um Endpoint pode retornar um formulário HTML, receber seu envio, salvar os dados e retornar uma página de agradecimento. O [exemplo de formulário de feedback](https://docs.tago.io/docs/tagoio/analysis/endpoints/recipes/serve-form) inclui tudo de que você precisa para criá-lo.

Outros exemplos mostram como [disponibilizar a configuração de um dispositivo](https://docs.tago.io/docs/tagoio/analysis/endpoints/recipes/device-configuration) e [exportar leituras em CSV](https://docs.tago.io/docs/tagoio/analysis/endpoints/recipes/export-csv).

## Desenvolva e teste no Admin

![O Try it do Admin envia uma requisição JSON para /orders e exibe uma resposta 200 OK que repete o corpo da requisição](https://tago.io/images/blog/introducing-analysis-endpoints/try-it.svg)

Teste requisições no Admin e inspecione a resposta que sua aplicação vai receber antes de conectá-la. O TagoAI pode ajudar a escrever o script Luau e habilitar seu Endpoint.

## Comece a usar

Os Analysis Endpoints estão disponíveis em todos os planos. As execuções em Luau não contam para o seu [limite do Analysis Service](https://docs.tago.io/docs/tagoio/profiles/services/analysis-service); as operações de dispositivos e outros recursos continuam sujeitas aos limites normais.

Consulte os [limites de chamadas e payload](https://docs.tago.io/docs/tagoio/analysis/endpoints/using-endpoints#limits-and-errors) ao dimensionar sua aplicação.

Leia o [guia de Analysis Endpoints](https://docs.tago.io/docs/tagoio/analysis/endpoints) e abra uma Analysis em Luau no [Admin](https://admin.tago.io) para habilitar seu Endpoint.

[llms.txt](https://tago.io/llms.txt)