API PostgREST

API REST gerada automaticamente a partir das suas tabelas PostgreSQL

Ative o PostgREST em qualquer servidor de banco de dados PostgreSQL e obtenha endpoints CRUD instantâneos. Sem código de backend, sem ORM, sem boilerplate. Seu schema é sua API.

Começar Documentação

Consulte sua API com HTTP padrão

# List users with filtering
curl https://myapp-api.sh0.app/users?select=name,email&role=eq.admin
# Insert a record
curl -X POST https://myapp-api.sh0.app/todos \
-H "Content-Type: application/json" \
-d '[object Object]'
# Joins via resource embedding
curl https://myapp-api.sh0.app/orders?select=id,total,customer(name,email)

Tudo o que você precisa de uma API REST

O PostgREST transforma seu banco de dados em um servidor de API completo sem nenhuma configuração.

Gerado Automaticamente a Partir do Schema

O PostgREST inspeciona suas tabelas, views e funções do PostgreSQL para gerar uma API REST completa automaticamente. Nenhuma etapa de geração de código necessária.

Filtragem, Paginação e Joins

Operadores de consulta integrados: eq, gt, lt, like, in, is e mais. Resource embedding para joins de chave estrangeira. Paginação por offset e cursor prontos para uso.

Especificação OpenAPI

Cada instância PostgREST expõe uma especificação OpenAPI ativa na sua raiz. Importe no Postman, gere SDKs de cliente ou alimente seu sistema de documentação.

Ativação com Um Clique

Selecione qualquer servidor de banco de dados PostgreSQL no painel do sh0 e ative o PostgREST com um único clique. Configuração automática, SSL automático.

Row-Level Security

Utilize políticas RLS do PostgreSQL para controlar o acesso no nível de linha. O PostgREST passa as claims do JWT como contexto de role para que suas políticas simplesmente funcionem.

Domínio com SSL Automático

Cada instância PostgREST recebe seu próprio subdomínio com HTTPS automático via Caddy. Conecte-se de qualquer frontend ou app mobile com segurança.

Como Funciona

01

Criar um Servidor PostgreSQL

Provisione um servidor de banco de dados PostgreSQL a partir do painel do sh0. Qualquer versão de 14 a 17.

02

Projetar Seu Schema

Crie tabelas, views e funções no seu banco de dados. Use o terminal integrado ou qualquer cliente PostgreSQL.

03

Ativar PostgREST

Ative o PostgREST no seu servidor de banco de dados. O sh0 implanta uma instância gerenciada do PostgREST e a conecta automaticamente.

04

Consultar via REST

Sua API está no ar. Use métodos HTTP padrão (GET, POST, PATCH, DELETE) com parâmetros de consulta poderosos.

Fluxo de Requisição

Requisição HTTP
Caddy (SSL)
PostgREST
PostgreSQL
Resposta JSON

O PostgREST se conecta diretamente ao PostgreSQL. Nenhum servidor de aplicação no meio.

Sem PostgREST

  • x Escrever rotas CRUD para cada tabela
  • x Manter modelos ORM e migrações
  • x Implementar filtragem, ordenação e paginação
  • x Escrever documentação de API manualmente
  • x Implantar e escalar um servidor de API separado
  • x Manter schema e API sincronizados

Com sh0 + PostgREST

  • API gerada automaticamente a partir do seu schema
  • O schema é a única fonte de verdade
  • Filtragem, ordenação e paginação integradas
  • Especificação OpenAPI gerada automaticamente
  • Deploy com um clique e SSL automático
  • Row-level security via PostgreSQL RLS

Perguntas Frequentes

Preciso escrever código de backend? +
Não. O PostgREST gera a API diretamente a partir do seu schema PostgreSQL. Você define tabelas, views e políticas RLS -- o PostgREST cuida da camada HTTP.
Posso usar o PostgREST com um banco de dados existente? +
Sim. Ative o PostgREST em qualquer servidor de banco de dados PostgreSQL gerenciado pelo sh0. Ele inspeciona seu schema existente e o expõe imediatamente.
Como funciona a autenticação? +
O PostgREST utiliza tokens JWT. Você pode combiná-lo com o serviço de autenticação do sh0 (Logto) para autenticação completa, ou usar qualquer emissor de JWT. As claims do token são passadas como contexto de role do PostgreSQL para RLS.
E quanto ao desempenho? +
O PostgREST é escrito em Haskell e é extremamente rápido. Ele se conecta diretamente ao PostgreSQL via pool de conexões e adiciona overhead mínimo às suas consultas.
Posso expor apenas determinadas tabelas? +
Sim. O PostgREST expõe apenas os schemas que você configurar (padrão: public). Use roles do PostgreSQL e instruções GRANT para controlar exatamente quais tabelas e operações estão disponíveis.
Isso é uma alternativa ao Supabase? +
O PostgREST é a mesma tecnologia central que alimenta a API gerada automaticamente pelo Supabase. Combinado com Auth, Realtime, Functions e Storage do sh0, você obtém um BaaS self-hosted completo.

Transforme seu banco de dados em uma API

Pare de escrever CRUD repetitivo. Ative o PostgREST e entregue seu frontend mais rápido.

Começar Leia a Documentação