O que é uma API?
Uma API (Application Programming Interface) funciona como um garçom em um restaurante. Quando você faz um pedido:
Você (o cliente) envia uma solicitação para a API (o garçom)
A API transmite essa solicitação ao servidor (a cozinha)
O servidor processa a solicitação e prepara uma resposta
A API entrega essa resposta de volta a você
Esta analogia ilustra perfeitamente o papel intermediário da API, que atua como ponte entre o usuário e o servidor da empresa.
Por que APIs são necessárias?
Existem quatro razões principais para usarmos APIs em vez de acessar diretamente os servidores:
Segurança: As APIs fornecem uma camada de proteção, evitando acesso direto aos servidores e seus dados sensíveis
Padronização: Mesmo empresas diferentes usam padrões semelhantes em suas APIs, facilitando o desenvolvimento de integrações
Escala e Performance: As APIs podem limitar requisições, garantindo que o sistema não seja sobrecarregado e mantenha boa performance para todos os usuários
Compatibilidade: A padronização das APIs permite que desenvolvedores acessem múltiplos serviços usando metodologias similares
Entendendo Requisições HTTP
As requisições HTTP (Protocolo de Transferência de Hipertexto) são como cartas enviadas a um destinatário. Cada requisição HTTP contém:
URL - O "endereço" do servidor (ex: tess.pareto.io/api/agents/{ID}/execute)
Método - A ação desejada (GET para obter informações, POST para enviar dados)
Headers (Cabeçalhos) - Informações adicionais como autenticação (ex: Authorization: Bearer + Token)
Body (Corpo) - O conteúdo da requisição, geralmente em formato JSON
Anatomia de uma Requisição HTTP para a TESS AI
Uma requisição típica para executar um agente na TESS inclui:
URL: Endereço específico que identifica o agente a ser executado
Método: Normalmente POST para executar ações
Headers:
Authorization com seu token de acesso
Content-Type indicando o formato (geralmente application/json)
Body: Dados em JSON contendo parâmetros como:
temperatura (nível de criatividade)
modelo a ser utilizado
mensagem a ser processada
ferramentas disponíveis
opções de espera pela execução
anexos (se necessário)
Exemplo de requisição HTTP
Suponha que você queira acessar a API da TESS AI e executar um agente. Você pode fazer uma requisição HTTP com a seguinte estrutura:
Método: POST
Headers: Authorization: Bearer [seu_token]
Body: JSON com informações do agente, como temperatura e modelo.
Esta introdução prepara o terreno para os próximos treinamentos, onde serão abordadas aplicações práticas, como executar agentes via API e processar as respostas recebidas!