API REST de base de datos: Convierta cualquier consulta SQL en un punto final.

API REST de base de datos · el hub

Convierta cualquier consulta SQL en un API REST punto final

Escriba una consulta en el Generador de consultas para cualquiera de los 59 conectores y haga clic. Nuevo punto finalTienes una URL en api.querystreams.com con su propia clave. La consulta SQL se ejecuta en modo de solo lectura en el agente que ya contiene tus datos; quienes la solicitan reciben JSON o CSV y nunca ven la consulta SQL, el esquema ni las credenciales. No necesitas alojar ningún servidor ni abrir ningún puerto, y está disponible en todos los planes, incluido el gratuito. Esta página ofrece una descripción general; cada conector tiene su propia guía más abajo.

Aproximadamente 90 segundos desde una consulta guardada No hay servidor que alojar Los datos permanecen en tu red. Una clave por persona que llama, revocable en cualquier momento.

Lo que obtendrás al final

Una URL que devuelve las filas de una consulta guardada a cualquier persona que tenga una clave, probada desde la consola del portal antes de compartirla. Algo así:

{
  "ciudad": "Seattle"
}

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"city": "Seattle"}'

{
  "columnas": [ { "nombre": "id_cliente", "tipo": "entero" }, { "nombre": "nombre", "tipo": "cadena" }, { "nombre": "ciudad", "tipo": "cadena" } ],
  "filas": [
    { "id_cliente": 1042, "nombre": "Comerciantes del Viento del Norte", "ciudad": "Seattle" },
    { "id_cliente": 1057, "nombre": "Alpine Outfitters", "ciudad": "Denver" },
    { "id_cliente": 1063, "nombre": "Comida del puerto", "ciudad": "Halifax" }
  ],
  "meta": { "row_count": 3, "agent_duration_ms": 41, "id_solicitud": "req_7Hq2mKd9" }
}

La mayoría de las herramientas que implementan una API REST en una base de datos, como PostgREST, Hasura, DreamFactory, Directus y los frameworks que uno mismo podría desarrollar, exponen el esquema: cada tabla se convierte en un endpoint y el usuario navega por ella. Query Streams hace lo contrario. Una consulta guardada define con precisión lo que devuelve un endpoint. El usuario recibe esas filas y nada más sobre cómo se generaron, y nunca se ejecuta un servidor API, ya que el agente que ya se tiene ejecuta la consulta y api.querystreams.com se encarga de la comunicación HTTP.

Lo que necesitarás

Una cuenta de Query Streams

Todos los planes incluyen la API REST. El plan gratuito ofrece un endpoint, dos claves y 250 filas por llamada, suficiente para crear esta guía. Regístrese en mi.querystreams.com.

El agente en un ordenador que puede acceder a su propia base de datos, con la conexión añadida

A menudo, se trata del propio servidor de la base de datos o de un ordenador que permanece siempre encendido en la misma red.

Una consulta guardada en el Generador de consultas

El punto final encapsula exactamente una consulta guardada. Escriba la sentencia SELECT, ejecútela una vez y guárdela. Agregue un filtro dinámico (un @variable en la cláusula WHERE) si los que llaman deberían poder filtrar.

Configúralo en cuatro pasos.

1. Guardar la consulta

   En Generador de consultas Seleccione una conexión, escriba la sentencia SELECT y ejecútela una vez. @variable En la cláusula WHERE se convierte en un parámetro de API:

   Consulta guardada · con un filtro dinámico

   SELECCIONE ID del cliente, nombre, ciudad
   DESDE clientes
   DONDE ciudad = @ciudad
   ORDEN POR nombre;

   Haga clic en Guardar; el nombre se convierte en el nombre para mostrar del punto final.

2. Crear el punto final

   Abrir API En la barra superior, haga clic. Nuevo punto finaly en Seleccionar consulta Haz clic en la consulta que guardaste. Haz clic Siguiente.

   API abierta

3. Configurar y bloquear parámetros

   En Configurar mantener Esperanza de vida Permanente, Modo de respuesta Estático y Formato interior JSON para un primer punto final; el modo y el formato se fijan una vez creados. En Parámetros de bloqueo dejar ciudad como Llamable, o Bloquear lo establece a un valor fijo que quien llama no puede cambiar. Haga clic. Siguiente.

4. Comparte y obtén tu clave.

   Invitar Gente por correo electrónico, agregue un Clave de servicio para una herramienta, o salte por ahora, luego haga clic Crea y obtén mi clave. Copie la clave de 49 caracteres que comienza qsapi_; se puede revelar de nuevo más tarde a partir del Compartir pestaña. Haga clic Enviar en la consola para realizar la primera llamada.

Llámalo desde cualquier lugar

Reemplace el ID del punto final con el suyo y qsapi_TU_CLAVE con su llave:

curl "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19?city=Seattle" \ -H "X-API-Key: qsapi_YOUR_KEY"

{
  "columnas": [ { "nombre": "id_cliente", "tipo": "entero" }, { "nombre": "nombre", "tipo": "cadena" }, { "nombre": "ciudad", "tipo": "cadena" } ],
  "filas": [
    { "id_cliente": 1042, "nombre": "Comerciantes del Viento del Norte", "ciudad": "Seattle" },
    { "id_cliente": 1057, "nombre": "Alpine Outfitters", "ciudad": "Denver" },
    { "id_cliente": 1063, "nombre": "Comida del puerto", "ciudad": "Halifax" }
  ],
  "meta": { "row_count": 3, "agent_duration_ms": 41, "id_solicitud": "req_7Hq2mKd9" }
}

Las filas se devuelven como objetos indexados por nombre de columna, con la lista de columnas y un meta Bloque que indica cuántas filas hay, si el resultado se recortó y el ID de la solicitud que puede citar para respaldar. La misma llamada como una POST coloca los parámetros en un cuerpo JSON, que es la opción correcta para listas largas de valores:

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"params": {"city": "Seattle"}}'

?formato=csv

CSV en lugar de JSON, con fila de encabezado incluida. Aceptar: texto/csv hace lo mismo. Los puntos finales de transmisión devuelven NDJSON (un objeto JSON por línea) con un final {"_summary": true, "row_count": N} línea; revisa esa última línea.

?muestra=verdadero

Máximo cinco filas, sin costo. Ideal para conectar a un cliente.

?compresión=lz4

Un cuerpo de bastidor LZ4 para llamadas de alto volumen con decodificador; Código La pestaña tiene el fragmento del decodificador por idioma. El gzip simple se realiza automáticamente cuando su cliente envía Codificación aceptada: gzip.

Autorización: Portador qsapi_…

Aceptado como alias de Clave X-APIÚsalo desde el código del navegador.

Dónde se enchufa

Guías por conector

Todos los conectores compatibles con Query Streams se pueden publicar de esta manera. Elige el tuyo:

Bases de datos que ejecuta

• Microsoft SQL Server
• PostgreSQL
• MySQL
• MariaDB
• Oracle
• SQLite
• Microsoft Access
• DuckDB
• Supabase

almacenes de datos

• Copo de nieve
• Google BigQuery

Bases de datos alojadas

• Neón
• Amazon RDS
• Base de datos Azure para PostgreSQL
• Base de datos Azure para MySQL
• Azure SQL
• Google Cloud SQL
• Base de datos de aleación de Google
• Bases de datos gestionadas por DigitalOcean
• Aiven
• Puente crujiente
• Heroku Postgres
• Prestar
• Ferrocarril
• Fly.io Postgres
• Bases de datos gestionadas por Vultr
• Bases de datos gestionadas por OVHcloud
• Bases de datos gestionadas por Scaleway
• Base de datos OCI con PostgreSQL
• MySQL HeatWave
• Bases de datos en la nube de IBM para PostgreSQL
• MariaDB SkySQL
• Xata
• Nube de escala temporal
• PlanetScale Postgres
• Prisma Postgres
• Koyeb
• Nilo

Carpetas de archivos y registros

• Sistema de archivos
• Carpeta CSV
• Carpeta de parquet
• Carpeta de Excel
• Carpeta SQLite
• Carpeta JSONL
• CSV de múltiples registros
• Registros de máquinas
• Registros del servidor web
• Registros de contenedores
• Registros de la aplicación
• Registros del sistema
• Registros personalizados

Conectores SaaS y API

• Raya
• Shopify
• HubSpot
• Anuncios de Google
• Google Analytics 4
• Consola de búsqueda de Google
• ShipStation
• iTick

Guías para el consumidor: Power BI y Excel a través de Power Query M.

Lo que permiten los planes

Cada llamada tiene un tiempo de espera fijo de 60 segundos para la consulta y un límite de respuesta de 8 MiB. Los bytes que devuelve se descuentan del límite de datos mensual de tu plan, el mismo que utilizan los complementos de Excel y Google Sheets. El plan gratuito incluye un punto final y 5 MB al mes, lo cual es suficiente para una tabla pequeña que se consulta varias veces al día. Consulte la página de precios. para las asignaciones por plan.

Mantenerlo seguro

Cuando algo no funciona

Cada cuerpo de error tiene la forma {"error": {"code": "…", "message": "…"}} y cada respuesta conlleva una ID de solicitud X-QS Encabezado. Cita el ID cuando escribas al soporte.

Preguntas que hace la gente

Guías relacionadas

• API REST de Power BI: conecta datos SQL en tiempo real sin controladores ODBC.
• Conectar flujos de consultas a Claude a través de MCP
• Comparte datos en tiempo real, no credenciales.
• Descripción general de las características de la API REST de la base de datos