Backend API

O que são Backend API?

Backend API (Application Programming Interface) é um conjunto de regras e endpoints que permitem a comunicação entre um cliente (como um frontend, um aplicativo móvel ou outro serviço) e um servidor backend.

Principais Características de uma Backend API:

1. Autenticação e Autorização – Controla o acesso aos dados (exemplo: OAuth, JWT).
2. Manipulação de Dados – Envia, recebe e processa informações no banco de dados.
3. Formatos de Resposta – Geralmente retorna dados em JSON ou XML.
4. Padrões de Comunicação – RESTful APIs, GraphQL ou WebSockets.

---

Catálogo de APIs (Monorepo)

Abaixo estão as APIs atualmente publicadas, com URL base, endpoint de saúde e exemplos rápidos de teste.

Observação: estes serviços são monitorados por health checks do GitHub Actions. Veja o status e links no README.md da raíz do repositório.

Rails (Ruby Functions)

• Stack: Ruby (Vercel Functions)
• Base: https://api-rails.vercel.app/
• Health: GET /api/health → 200

Exemplos:

curl -i https://api-rails.vercel.app/
curl -i https://api-rails.vercel.app/api/health

Express (Node)

• Stack: Node + Express
• Base: https://api-express-psi-red.vercel.app/
• Health: GET /health → 200

Exemplos:

curl -i https://api-express-psi-red.vercel.app/health

NestJS (Node)

• Stack: Node + NestJS
• Base: https://api-nest-three.vercel.app/
• Health: GET /health → 200

Exemplos:

curl -i https://api-nest-three.vercel.app/health

Go

• Stack: Go
• Base: https://api-go-flax.vercel.app/
• Health: GET /health → 200

Exemplos:

curl -i https://api-go-flax.vercel.app/health

Django (Python)

• Stack: Python + Django
• Base: https://api-django-five.vercel.app/
• Health: GET /health → 200

Exemplos:

curl -i https://api-django-five.vercel.app/health

Laravel (PHP)

• Stack: PHP + Laravel
• Base: https://api-laravel-nu.vercel.app/
• Health: GET /health → 200

Exemplos:

curl -i https://api-laravel-nu.vercel.app/health

Bash (Vercel Bash)

• Stack: Bash (vercel-bash)
• Base: https://api-bash-ten.vercel.app/
• Health: GET /api/health → 200

Exemplos:

curl -i https://api-bash-ten.vercel.app/api/health

Deno (TypeScript)

• Stack: Deno (vercel-deno)
• Base: https://api-deno.vercel.app/
• Health: GET /api/health → 200

Exemplos:

curl -i https://api-deno.vercel.app/api/health

---

Boas práticas

• Padronize /health para respostas rápidas com HTTP 200.
• Versione a API (por ex.: /v1) quando for necessário evoluir sem quebrar clientes.
• Documente endpoints (OpenAPI/Swagger) quando aplicável.
• Monitore latência e erros. Health checks simples ajudam a identificar quedas.