API REST de CSV: Transforme uma consulta SQL em arquivos CSV e crie um endpoint.

API REST · Pasta CSV para um endpoint

Vire um Pasta CSV Consulta SQL em um API REST ponto final

Para salvar uma consulta no Construtor de Consultas, clique em Novo ponto final, and you have a URL at api.querystreams.com with its own key. The SQL runs read-only on the Agent that already reads your CSV Folder file; the caller gets JSON or CSV and never sees the SQL, the schema or a password. Nothing to host, no port to open. About 90 seconds from a saved query, and the Free plan covers your first endpoint.

Aproximadamente 90 segundos a partir de uma consulta salva Nenhum servidor para hospedar O arquivo permanece onde está. Uma chave por chamador, revogue a qualquer momento.

O resultado final será o que você obterá.

Um URL em api.querystreams.com que retorna as linhas da sua consulta salva na pasta CSV como JSON ou CSV para qualquer pessoa que possua a chave, testada no console do portal antes de ser compartilhada. Assim:

{
  "first_row_id": "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 '{"first_row_id": "Seattle"}'

{
  "colunas": [ { "nome": "_arquivo_fonte", "tipo": "inteiro" }, { "nome": "contagem_de_linhas", "tipo": "corda" }, { "nome": "first_row_id", "tipo": "corda" } ],
  "fileiras": [
    { "_arquivo_fonte": 1042, "contagem_de_linhas": "Comerciantes do Vento Norte", "first_row_id": "Seattle" },
    { "_arquivo_fonte": 1057, "contagem_de_linhas": "Alpine Outfitters", "first_row_id": "Denver" },
    { "_arquivo_fonte": 1063, "contagem_de_linhas": "Alimentos do Porto", "first_row_id": "Halifax" }
  ],
  "meta": { "contagem_de_linhas": 3, "duração_do_agente_ms": 41, "id_da_solicitação": "req_7Hq2mKd9" }
}

A pasta CSV armazena seus dados em arquivos em um computador que você controla. Alguém precisa de uma parte desses dados em seu aplicativo, painel ou script, e as soluções usuais geralmente envolvem muita coisa: um login de banco de dados que se torna obsoleto após o término do projeto, uma exportação noturna que já está desatualizada antes do café da manhã, ou um pequeno servidor de API que alguém precisa manter atualizado. O Query Streams transforma o endpoint em uma consulta salva e uma chave. O agente que já possui uma pasta com os arquivos CSV executa a consulta, o api.querystreams.com verifica a chave e o limite de requisições, e o solicitante recebe as linhas. O SQL, o esquema e as credenciais nunca saem da sua conta.

O que você vai precisar

Uma conta do Query Streams

Todos os planos incluem a API REST. O plano gratuito oferece um endpoint, duas chaves e 250 linhas por chamada, o suficiente para criar este guia. Cadastre-se em my.querystreams.com.

The Agent with your CSV Folder file added as a connection

Ainda não terminou? Adicione em Dados → Agentes de Dados; leva cerca de dez minutos.

Uma consulta salva no Construtor de Consultas

O endpoint encapsula exatamente uma consulta salva. Escreva o SELECT, execute-o uma vez e salve-o. Adicione um filtro dinâmico (um @variable (na cláusula WHERE) se os chamadores devem poder filtrar.

Configure em quatro etapas

1. Salvar consulta

   Em Construtor de consultas Selecione a sua conexão com a pasta CSV, escreva a instrução SELECT que deseja publicar e execute-a uma vez para visualizar as linhas. Limite-se às colunas que o chamador precisa; o endpoint retorna exatamente o que a consulta retorna.

   Consulta salva · fileset.sales

   SELECIONAR _arquivo_fonte, CONTAGEM(*) AS contagem_de_linhas, MIN(_row_id) AS primeiro_id_da_linha DE conjunto de arquivos.vendas GRUPO POR _arquivo_fonte ORDEM POR contagem de linhas DESC LIMITE 100

   Se os usuários precisarem poder filtrar, adicione um Filtro Dinâmico, por exemplo. ONDE first_row_id = @first_row_id. Cada @variable torna-se um parâmetro da API na etapa 3. Clique. Salvar e dê um nome à consulta; esse nome se tornará o nome de exibição do endpoint.

2. Crie o endpoint

   Aberto API na barra superior e clique Novo ponto finalO assistente tem quatro etapas. Selecione a consulta, Configurar, Parâmetros de bloqueio e Compartilhar. Sobre Selecione a consultaClique na consulta que você acabou de salvar; as consultas cujo agente está offline aparecem em cinza. Clique Próximo.

   API aberta

   Atalho. A partir do Construtor de Consultas, você pode expor a consulta aberta diretamente; o assistente então inicia em Configurar com a consulta já selecionada.

3. Configurar e bloquear parâmetros

   Sobre Configurar As configurações padrão estão corretas para um primeiro ponto de extremidade: Nome de exibição preenchido a partir da consulta, Vida útil Permanente (escolha) Expirando (para uma participação temporária), Modo de resposta Estático (uma resposta JSON; escolha Transmissão (para resultados que excedam o limite estático de linhas do seu plano), Formato interno JSON. O modo e o formato da resposta são fixos após a criação, portanto, defina-os aqui. Clique. Próximo.

   Sobre Parâmetros de bloqueio Todos os filtros dinâmicos na consulta são listados. Deixe como estão aqueles que os chamadores podem definir. Invocável e dê a cada um um Nome da string de consulta; marcação Obrigatório Se uma chamada sem ele falhar, fixe um valor que o chamador não deve alterar. Trancadoou um cenário de encontro como Início do mês. Escondido Mantém o valor padrão da consulta e rejeita qualquer tentativa de alterá-lo. Clique. Próximo.

4. Compartilhe e ganhe sua chave.

   Sobre Compartilhar você pode convidar Pessoas por e-mail ou adicione um Chave de serviço Para um servidor ou uma ferramenta de automação, ou ignore ambos por enquanto. Clique. Criar e obter minha chaveA tela de sucesso exibe o URL do endpoint e sua chave: uma string de 49 caracteres começando com qsapi_Copie-o. Você poderá exibi-lo novamente mais tarde a partir do ponto de extremidade. Compartilhamento aba, para que não se perca se você fechar a tela.

   Clique em Enviar no console para fazer a primeira chamada a partir do próprio portal. O painel de resposta mostra Status, Tempo e Tamanho, o Corpo A aba exibe o JSON e a chamada aparece no Atividade alguns segundos depois.

Ligue de qualquer lugar

Substitua o ID do endpoint pelo seu, que você encontra na barra de URL do console. qsapi_SUA_CHAVE com sua chave. Os parâmetros chamáveis vão na string de consulta do GET; aqui a consulta salva expõe primeiro_id_da_linha:

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

{
  "colunas": [ { "nome": "_arquivo_fonte", "tipo": "inteiro" }, { "nome": "contagem_de_linhas", "tipo": "corda" }, { "nome": "first_row_id", "tipo": "corda" } ],
  "fileiras": [
    { "_arquivo_fonte": 1042, "contagem_de_linhas": "Comerciantes do Vento Norte", "first_row_id": "Seattle" },
    { "_arquivo_fonte": 1057, "contagem_de_linhas": "Alpine Outfitters", "first_row_id": "Denver" },
    { "_arquivo_fonte": 1063, "contagem_de_linhas": "Alimentos do Porto", "first_row_id": "Halifax" }
  ],
  "meta": { "contagem_de_linhas": 3, "duração_do_agente_ms": 41, "id_da_solicitação": "req_7Hq2mKd9" }
}

As linhas retornam como objetos indexados pelo nome da coluna, com a lista de colunas e um meta Bloco que informa quantas linhas existem, se o resultado foi truncado e o ID da solicitação que você pode citar para suporte. A mesma chamada que um POST coloca os parâmetros em um corpo JSON, que é a escolha certa para longas listas 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": {"first_row_id": "Seattle"}}'

?formato=csv

CSV em vez de JSON, com linha de cabeçalho incluída. Aceitar: texto/csv faz o mesmo. Os endpoints de streaming retornam NDJSON (um objeto JSON por linha) com um final {"_summary": true, "row_count": N} linha; verifique essa última linha.

?sample=true

No máximo cinco linhas, sem cobrança. Ideal para conectar os cabos de um cliente.

?compressão=lz4

Um corpo de estrutura LZ4 para chamadas de alto volume com decodificador; o Código A aba contém o trecho de código decodificador para cada idioma. A compressão gzip simples ocorre automaticamente quando seu cliente envia o arquivo. Codificação aceita: gzip.

Autorização: Portador qsapi_…

Aceito como um pseudônimo para Chave X-APIUse-o a partir do código do navegador.

Onde ele se conecta

O que os planos permitem

Cada chamada também possui um tempo limite fixo de consulta de 60 segundos e um limite de resposta de 8 MiB, e os bytes retornados são contabilizados na sua franquia de dados mensal, a mesma franquia usada pelos suplementos do Excel e do Google Sheets. O plano gratuito inclui um endpoint e 5 MB por mês, o que é suficiente para uma pequena tabela acessada várias vezes ao dia. Consulte a página de preços. para as verbas previstas no plano.

Mantendo-o seguro

Quando algo não funciona

Cada corpo de erro tem a forma {"erro": {"código": "…", "mensagem": "…"}} e cada resposta carrega um X-QS-Request-Id Ao entrar em contato com o suporte, mencione o ID no cabeçalho.

Perguntas que as pessoas fazem

Guias relacionados

• Como conectar uma pasta CSV ao Google Sheets
• Conecte a pasta CSV ao Claude com o MCP.
• API REST de banco de dados: transforme qualquer consulta SQL em um endpoint.
• API REST do Microsoft SQL Server
• API REST do PostgreSQL
• API REST do MySQL