API PostgREST

API REST autogenerada desde tus tablas PostgreSQL

Habilita PostgREST en cualquier servidor de base de datos PostgreSQL y obtén endpoints CRUD al instante. Sin código de backend, sin ORM, sin repeticiones. Tu esquema es tu API.

Comenzar Documentación

Consulta tu API con HTTP estándar

# 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)

Todo lo que necesitas de una API REST

PostgREST convierte tu base de datos en un servidor API completo sin configuración.

Generada automáticamente desde el esquema

PostgREST inspecciona tus tablas, vistas y funciones de PostgreSQL para generar una API REST completa automáticamente. No se requiere un paso de generación de código.

Filtrado, paginación y joins

Operadores de consulta integrados: eq, gt, lt, like, in, is y más. Incrustación de recursos para joins con claves foráneas. Paginación por desplazamiento y cursor incluida.

Especificación OpenAPI

Cada instancia de PostgREST expone una especificación OpenAPI en vivo en su raíz. Impórtala en Postman, genera SDKs de cliente o aliméntala a tu sistema de documentación.

Activación con un clic

Selecciona cualquier servidor de base de datos PostgreSQL en tu panel de sh0 y habilita PostgREST con un solo interruptor. Configuración automática, SSL automático.

Seguridad a nivel de fila

Aprovecha las políticas RLS de PostgreSQL para controlar el acceso a nivel de fila. PostgREST pasa los claims JWT como contexto de rol para que tus políticas funcionen directamente.

Dominio con Auto-SSL

Cada instancia de PostgREST obtiene su propio subdominio con HTTPS automático a través de Caddy. Conéctate desde cualquier frontend o aplicación móvil de forma segura.

Cómo funciona

01

Crear un servidor PostgreSQL

Aprovisiona un servidor de base de datos PostgreSQL desde el panel de sh0. Cualquier versión de la 14 a la 17.

02

Diseña tu esquema

Crea tablas, vistas y funciones en tu base de datos. Usa la terminal integrada o cualquier cliente PostgreSQL.

03

Habilitar PostgREST

Activa PostgREST para tu servidor de base de datos. sh0 despliega una instancia gestionada de PostgREST y la conecta automáticamente.

04

Consulta vía REST

Tu API está activa. Usa métodos HTTP estándar (GET, POST, PATCH, DELETE) con potentes parámetros de consulta.

Flujo de solicitud

Solicitud HTTP
Caddy (SSL)
PostgREST
PostgreSQL
Respuesta JSON

PostgREST se conecta directamente a PostgreSQL. Sin servidor de aplicaciones intermedio.

Sin PostgREST

  • x Escribir rutas CRUD para cada tabla
  • x Mantener modelos ORM y migraciones
  • x Implementar filtrado, ordenación y paginación
  • x Escribir documentación de API manualmente
  • x Desplegar y escalar un servidor API separado
  • x Mantener esquema y API sincronizados

Con sh0 + PostgREST

  • API autogenerada desde tu esquema
  • El esquema es la fuente de verdad
  • Filtrado, ordenación y paginación integrados
  • Especificación OpenAPI generada automáticamente
  • Despliegue con un clic y Auto-SSL
  • Seguridad a nivel de fila con PostgreSQL RLS

Preguntas frecuentes

¿Necesito escribir código de backend? +
No. PostgREST genera la API directamente desde tu esquema PostgreSQL. Tú defines tablas, vistas y políticas RLS; PostgREST gestiona la capa HTTP.
¿Puedo usar PostgREST con una base de datos existente? +
Sí. Habilita PostgREST en cualquier servidor de base de datos PostgreSQL gestionado por sh0. Inspecciona tu esquema existente y lo expone de inmediato.
¿Cómo se gestiona la autenticación? +
PostgREST usa tokens JWT. Puedes combinarlo con el servicio sh0 Auth (Logto) para una autenticación completa, o usar cualquier emisor JWT. Los claims del token se pasan como contexto de rol de PostgreSQL para RLS.
¿Qué hay del rendimiento? +
PostgREST está escrito en Haskell y es extremadamente rápido. Se conecta directamente a PostgreSQL a través de un pool de conexiones y añade una sobrecarga mínima a tus consultas.
¿Puedo exponer solo ciertas tablas? +
Sí. PostgREST expone solo los esquemas que configures (por defecto: public). Usa roles de PostgreSQL y sentencias GRANT para controlar exactamente qué tablas y operaciones están disponibles.
¿Es esto una alternativa a Supabase? +
PostgREST es la misma tecnología central que impulsa la API autogenerada de Supabase. Combinado con Auth, Realtime, Functions y Storage de sh0, obtienes un BaaS autoalojado completo.

Convierte tu base de datos en una API

Deja de escribir CRUD repetitivo. Habilita PostgREST y lanza tu frontend más rápido.

Comenzar Leer la documentación