Pular para o Conteúdo

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)

Exemplos:

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

Express (Node)

Exemplos:

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

NestJS (Node)

Exemplos:

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

Go

Exemplos:

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

Django (Python)

Exemplos:

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

Laravel (PHP)

Exemplos:

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

Bash (Vercel Bash)

Exemplos:

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

Deno (TypeScript)

Exemplos:

bash
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.

Lançado sob a licença MIT.