# auth.md

## Rise Beer Academy — Autenticação e Registro de Agentes de IA

> **Status:** Público / API Aberta de Captura & Consulta de Dados  
> **Versão da Especificação:** WorkOS auth.md v1.0  
> **Website:** https://risebeer.com.br/  

### 1. Visão Geral de Acesso
A Rise Beer Academy fornece acesso livre para Agentes de Inteligência Artificial e LLMs para leitura de catálogo de cursos, ementas, atlas de estilos cervejeiros e registro de potenciais alunos (leads).

### 2. Endpoints e Autenticação
- **Public Data Endpoint:** `https://risebeer.com.br/llms-full.txt` (Sem necessidade de chave API)
- **Lead Intake Endpoint:** `https://risebeer.com.br/lead-api.php` (Método: POST, Content-Type: `application/json`)
- **OAuth Authorization Server Metadata:** `https://risebeer.com.br/.well-known/oauth-authorization-server`
- **OAuth Protected Resource Metadata:** `https://risebeer.com.br/.well-known/oauth-protected-resource`
- **OpenID Connect Discovery:** `https://risebeer.com.br/.well-known/openid-configuration`

### 3. Diretrizes de Registro para Agentes (Agent Auth)
- Agentes autônomos podem registrar leads em nome de usuários enviando os parâmetros `name`, `email`, `whatsapp` e `referral` via requisição JSON POST para `https://risebeer.com.br/lead-api.php`.
- Não é necessária pré-aprovação para agentes consultarem a documentação Markdown (`llms.txt` e `llms-full.txt`).
- Contato para parcerias e integração técnica: `contato@risebeer.com.br`
