Portfolio API Documentation v1.0.0
Base URL: https://portfolio-api-6kng.onrender.com
Esta API Restful foi projetada para lidar com o envio de formulários do portfólio. Ela possui rotas de contato e depoimentos, e conta com camadas de defesa cibernética contra robôs de spam (Honeypot) e ataques DDoS (Rate Limiting).
POST
/api/contact
Envia uma mensagem de contato
Request Body (application/json)
{
"name": "string", // Obrigatório. Nome do remetente.
"email": "string", // Obrigatório. E-mail de retorno.
"message": "string", // Obrigatório. Conteúdo da mensagem.
"website": "string" // Opcional. Armadilha Honeypot. Se preenchido, a requisição sofre Ghost Banning.
}
Responses
| Code | Description | Example (JSON) |
|---|---|---|
| 200 | Success - E-mail enviado. (Também retornado em Ghost Banning). | "sucesso": true |
| 400 | Bad Request - Campos obrigatórios ausentes. | "erro": "Todos os campos..." |
| 429 | Too Many Requests - Limite de taxa excedido (3 requisições / 15 min). | "erro": "Muitas tentativas..." |
POST
/api/testimonial
Registra um novo depoimento
Request Body (application/json)
{
"name": "string", // Obrigatório. Nome da pessoa.
"role": "string", // Obrigatório. Cargo ou Empresa.
"message": "string", // Obrigatório. Texto do depoimento.
"website": "string" // Opcional. Honeypot para spambots.
}
Responses
| Code | Description | Example (JSON) |
|---|---|---|
| 200 | Success - Depoimento recebido para moderação. | "sucesso": true |
| 400 | Bad Request - Parâmetros inválidos. | "erro": "Todos os campos..." |
| 500 | Internal Server Error - Falha no provedor Resend. | "erro": "Falha interna..." |