Balikkan apa saja Kueri SQL menjadi sebuah API REST titik akhir
Tulis kueri di Query Builder terhadap salah satu dari 59 konektor, lalu klik Titik akhir baru, dan Anda memiliki URL di api.querystreams.com dengan kunci tersendiri. SQL berjalan hanya baca pada Agen yang sudah ada dengan data Anda; pemanggil mendapatkan JSON atau CSV dan tidak pernah melihat SQL, skema, atau kredensial. Tidak perlu server untuk dihosting, tidak perlu port untuk dibuka, dan semua paket termasuk Gratis memilikinya. Halaman ini adalah gambaran umum; setiap konektor memiliki panduannya sendiri di bawah ini.
Inilah hasil akhirnya
URL yang mengembalikan baris dari kueri yang tersimpan kepada siapa pun yang memegang kunci, diuji dari konsol di portal sebelum Anda membagikannya. Seperti ini:
| Kunci | Nilai | Keterangan |
|---|---|---|
kota rangkaian Opsional | Seattle | Filter yang dapat dipanggil dari kueri yang tersimpan |
Kunci API X | qsapi_AB•••••••••• | Token rahasia Anda |
{
"kota": "Seattle"
}| Judul | Nilai | Keterangan |
|---|---|---|
Kunci API X | qsapi_AB•••••••••• | Token rahasia Anda. Satu token per pemanggil, dapat dicabut kapan saja. |
Jenis Konten | aplikasi/json | Parameter-parameter tersebut dikirim sebagai isi JSON. |
Menerima | aplikasi/json | JSON sebagai input; jika diminta teks/csv, Anda akan mendapatkan CSV. |
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"}'{
"kolom": [ { "nama": "ID pelanggan", "jenis": "bilangan bulat" }, { "nama": "nama", "jenis": "rangkaian" }, { "nama": "kota", "jenis": "rangkaian" } ],
baris: [
{ "ID pelanggan": 1042, "nama": "Pedagang Angin Utara", "kota": "Seattle" },
{ "ID pelanggan": 1057, "nama": "Penyedia Perlengkapan Pegunungan Alpen", "kota": "Denver" },
{ "ID pelanggan": 1063, "nama": "Harbour Foods", "kota": "Halifax" }
],
"meta": { "jumlah_baris": 3, "durasi_agen_ms": 41, "request_id": "req_7Hq2mKd9" }
}| Judul | Nilai | Keterangan |
|---|---|---|
tipe konten | aplikasi/json; charset=utf-8 | Amplop pada tab Isi |
panjang konten | 412 | Byte dikembalikan; lencana Ukuran di atas |
Sebagian besar alat yang menempatkan REST API pada basis data, seperti PostgREST, Hasura, DreamFactory, Directus, dan framework yang Anda tulis sendiri, mengekspos skema: setiap tabel menjadi endpoint dan pemanggil dapat menelusurinya. Query Streams melakukan hal sebaliknya. Satu query yang tersimpan menentukan dengan tepat apa yang dikembalikan oleh sebuah endpoint. Pemanggil mendapatkan baris-baris tersebut dan tidak ada informasi lain tentang bagaimana baris-baris tersebut dihasilkan, dan Anda tidak pernah menjalankan server API, karena Agent yang sudah Anda miliki menjalankan query dan api.querystreams.com menangani HTTP.
Yang Anda butuhkan
Akun Query Streams
Semua paket memiliki REST API. Paket gratis memberi Anda satu endpoint, dua kunci, dan 250 baris per panggilan, yang cukup untuk membuat panduan ini. Daftar di sini. my.querystreams.com.
Agen pada komputer yang dapat mengakses basis data Anda sendiri, dengan koneksi yang ditambahkan.
Seringkali server basis data itu sendiri atau komputer yang selalu aktif di jaringan yang sama.
Kueri yang tersimpan di Query Builder
Endpoint tersebut membungkus tepat satu kueri yang tersimpan. Tulis SELECT, jalankan sekali, lalu simpan. Tambahkan Filter Dinamis (sebuah @variable (dalam klausa WHERE) jika pemanggil harus dapat melakukan filter.
Siapa yang dapat membuat endpoint? Pemilik, Admin, dan Pembuat. Jika API Item tersebut hilang dari bilah atas Anda, Admin dapat mengaktifkannya untuk pengguna Anda di bawah ini. Akun → IzinSiapa pun yang Anda ajak berbagi endpoint hanya memerlukan akun Query Streams, di paket mana pun.
Siapkan dalam empat langkah
Simpan kueri
Di dalam Pembuat Kueri Pilih koneksi, tulis perintah SELECT, dan jalankan sekali. A
@variabledalam klausa WHERE menjadi parameter API:Kueri tersimpan · dengan satu Filter DinamisPILIH ID pelanggan, nama, kota DARI pelanggan DI MANA kota = @kota MEMESAN OLEH nama;
Klik Simpan; nama tersebut menjadi nama tampilan endpoint.
Buat titik akhir
Membuka API di bilah atas, klik Titik akhir baru, dan pada Pilih kueri Klik kueri yang telah Anda simpan. Klik Berikutnya.
Konfigurasi dan kunci parameter
Pada Konfigurasi menyimpan Jangka hidup Permanen, Mode respons Statis dan Format internal JSON untuk endpoint pertama; mode dan format akan tetap setelah dibuat. Pada Kunci parameter meninggalkan
kotasebagai Dapat dipanggil, atau Kunci menetapkannya ke nilai tetap yang tidak dapat diubah oleh pemanggil. Klik Berikutnya.Bagikan dan dapatkan kunci Anda
Mengundang Rakyat melalui email, tambahkan Kunci layanan untuk sebuah alat, atau lewati untuk sementara, lalu klik Buat & dapatkan kunci sayaSalin kunci 49 karakter yang dimulai dengan
qsapi_; hal itu dapat diungkapkan kembali nanti dari Berbagi tab. Klik Mengirim di konsol untuk melakukan panggilan pertama.
Itu saja. Kueri tersebut menjawab pertanyaan pada URL, hanya untuk dibaca, berdasarkan kunci yang Anda berikan. Setiap panduan konektor di bawah ini menjelaskan empat langkah yang sama dengan SQL konektor tersebut dan hal-hal khusus yang terkait dengannya.
Lakukan panggilan dari mana saja
Ganti ID endpoint dengan ID Anda dan qsapi_KUNCI_ANDA dengan kunci Anda:
curl "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19?city=Seattle" \ -H "X-API-Key: qsapi_KUNCI_ANDA"
{
"kolom": [ { "nama": "ID pelanggan", "jenis": "bilangan bulat" }, { "nama": "nama", "jenis": "rangkaian" }, { "nama": "kota", "jenis": "rangkaian" } ],
baris: [
{ "ID pelanggan": 1042, "nama": "Pedagang Angin Utara", "kota": "Seattle" },
{ "ID pelanggan": 1057, "nama": "Penyedia Perlengkapan Pegunungan Alpen", "kota": "Denver" },
{ "ID pelanggan": 1063, "nama": "Harbour Foods", "kota": "Halifax" }
],
"meta": { "jumlah_baris": 3, "durasi_agen_ms": 41, "request_id": "req_7Hq2mKd9" }
}Baris dikembalikan sebagai objek yang dikunci berdasarkan nama kolom, dengan daftar kolom dan sebuah meta Blok yang memberi tahu Anda berapa banyak baris yang ada, apakah hasilnya terpotong, dan ID permintaan yang dapat Anda kutip untuk mendukung permintaan tersebut. Panggilan yang sama seperti POST menempatkan parameter dalam badan JSON, yang merupakan pilihan tepat untuk daftar nilai yang panjang:
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"}}'?format=csv- CSV, bukan JSON, termasuk baris header.
Menerima format teks/csvmelakukan hal yang sama. Endpoint streaming mengembalikan NDJSON (satu objek JSON per baris) dengan akhiran{"_ringkasan": benar, "jumlah_baris": N}baris; periksa baris terakhir itu. ?sampel=benar- Maksimal lima baris, tidak dikenakan biaya. Cocok untuk memasang kabel pada klien.
kompresi=lz4- Badan rangka LZ4 untuk penelepon bervolume tinggi dengan dekoder; Kode Tab tersebut berisi cuplikan dekoder per bahasa. Kompresi gzip biasa terjadi secara otomatis saat klien Anda mengirimkan data.
Accept-Encoding: gzip. Otorisasi: Bearer qsapi_…- Diterima sebagai alias untuk
Kunci API XGunakan dari kode browser.
Di mana colokannya
Excel dan Power BI
Ekspor → Power Query M (.pq) Ini memberi Anda kueri siap pakai. Tempelkan ke Editor Lanjutan (Excel: Data → Dapatkan Data → Dari Sumber Lain → Kueri Kosong; Power BI: Beranda → Ubah data → Sumber Baru → Kueri Kosong) dan ganti placeholder dengan kueri Anda. qsapi_ kunci.
Tukang Pos, Insomnia, Hoppscotch
Sama saja Ekspor Menu mengunduh koleksi Postman v2.1, ekspor Insomnia v5, atau koleksi Hoppscotch dengan parameter yang sudah terisi dan tempat penampung untuk kunci.
Kode Anda sendiri
Itu Kode Tab ini memiliki contoh kerja untuk cURL, Python, JavaScript, TypeScript, Java, C#, Go, PHP, PowerShell, dan Ruby. Ekspor → Spesifikasi OpenAPI 3.1 Mengumpan ke generator klien atau Swagger UI apa pun.
n8n, Zapier, Make, cron
Buat Kunci layanan Untuk alat tersebut, tempelkan URL dan kunci ke node HTTP-nya, lalu jadwalkan. Setiap alat mendapatkan kuncinya sendiri, sehingga Anda dapat mencabut satu alat tanpa memengaruhi alat lainnya.
Panduan berdasarkan konektor
Semua konektor yang didukung Query Streams dapat dipublikasikan dengan cara ini. Pilih milik Anda:
Basis data yang Anda jalankan
Gudang data
Basis data yang dihosting
Folder berisi file dan log
Konektor SaaS dan API
Panduan untuk konsumen: Power BI dan Excel melalui Power Query M.
Apa yang diizinkan oleh rencana tersebut
| Rencana | Titik akhir | Kunci per titik akhir | Jumlah orang per titik akhir | Baris per panggilan (statis) | Baris per panggilan (streaming) | Panggilan per menit, per tombol |
|---|---|---|---|---|---|---|
| Gratis | 1 | 2 | 1 | 250 | 250 | 3 |
| Inti Pribadi | 2 | 3 | 2 | 5,000 | 250,000 | 15 |
| Personal Plus | 5 | 5 | 5 | 10,000 | 500,000 | 30 |
| Inti Bisnis | 5 | 10 | 10 | 50,000 | 1,000,000 | 300 |
| Bisnis Plus | 10 | 20 | 25 | 100,000 | 5,000,000 | 600 |
| Bisnis Max | 25 | 30 | 50 | 250,000 | 10,000,000 | 600 |
| Inti Perusahaan | 50 | 50 | 100 | 500,000 | 25,000,000 | 1,000 |
| Perusahaan Plus | 100 | 100 | 250 | 1,000,000 | 50,000,000 | 1,000 |
| Enterprise Max | 250 | 200 | 500 | 2,500,000 | 100,000,000 | 1,500 |
Setiap panggilan juga memiliki batas waktu kueri tetap 60 detik dan batas respons 8 MiB, dan byte yang dikembalikan akan dihitung terhadap kuota data bulanan paket Anda, kuota yang sama yang digunakan oleh add-in Excel dan Google Sheets. Paket gratis memiliki satu endpoint dan 5 MB per bulan, yang cukup untuk tabel kecil yang dipanggil berkali-kali dalam sehari. Lihat halaman harga. untuk tunjangan berdasarkan rencana.
Gratis adalah rencana yang bisa Anda pertahankan. Ini bukan masa percobaan yang berakhir. Lihat detail lengkapnya di sini. halaman harga.
Menjaganya tetap aman
SQL tersebut tetap milik Anda.
Pihak yang melakukan panggilan hanya mendapatkan baris data. Mereka tidak pernah melihat kueri, nama tabel, atau detail koneksi, dan mereka tidak dapat mengubah apa yang dijalankan oleh endpoint tersebut.
Satu kunci, satu titik akhir, satu pemanggil
Satu kunci hanya berlaku untuk satu titik akhir. Berikan setiap orang atau alat kuncinya masing-masing, dan setiap panggilan akan dicatat terhadap kunci tersebut. Cabut satu kunci dan kunci lainnya akan tetap berfungsi; pencabutan akan berlaku dalam waktu sekitar lima menit.
Hanya baca, di sisi dinding Anda.
Agen hanya menjalankan satu perintah SELECT yang tersimpan dan tidak ada yang lain, dari dalam jaringan Anda, melalui koneksi keluarnya sendiri. Tidak ada port yang perlu dibuka dan tidak ada kredensial di internet.
Setiap panggilan dalam buku besar
Itu Aktivitas Tab ini menampilkan setiap panggilan beserta waktu, penerima, status, baris, byte, dan durasi, termasuk panggilan yang ditolak. Atur sebuah Berakhir Masa berlaku untuk share sementara dan endpoint akan mati secara otomatis pada tanggal tersebut.
Ketika sesuatu tidak berfungsi
| Status | Kode | Apa yang harus dilakukan? |
|---|---|---|
| 401 | API_KEY_REQUIRED / API_KEY_INVALID | Header hilang atau kuncinya salah. Kirim Kunci API-X: qsapi_…, keseluruhan 49 karakter. Kunci dapat disalin lagi dari tab Berbagi di endpoint. |
| 403 | API_KEY_ENDPOINT_MISMATCH | Kunci yang valid digunakan pada endpoint yang berbeda. Setiap kunci hanya milik satu endpoint. |
| 403 | KUNCI_API_DICABUT / TITIK_AKHIR_API_KADALUARSA | Kunci telah dicabut atau titik akhir telah mencapai tanggal kedaluwarsa. Buat kunci baru atau pulihkan titik akhir. |
| 400 | API_PARAM_TIDAK_DAPAT_DITIMPA | Anda mengirimkan parameter yang tidak ditandai sebagai "Dapat Dipanggil" oleh pemiliknya. Isi permintaan mencantumkan nama-nama yang diizinkan. |
| 414 | API_QUERY_TERLALU_BESAR | String kueri GET yang dikirimkan berukuran 8 KB atau 200 nilai daftar. Kirimkan parameter yang sama seperti pada body JSON POST. |
| 413 | API_OUTPUT_TERLALU_BESAR | Hasilnya melebihi batas 8 MiB. Persempit kueri, atau alihkan endpoint ke Streaming. |
| 429 | API_RATE_LIMITED | Terlalu banyak panggilan saat ini untuk kunci atau titik akhir. Tunggu sebentar. Coba Lagi Setelahnya detik, atau tingkatkan Batas laju di bawah Pengaturan API → Pengaturan default dalam paket Anda. |
| 429 | API_DATA_REALM_KEHAUSAN | Kuota data bulanan pemilik telah habis. Kuota akan direset pada bulan penagihan; tingkatkan paket untuk mendapatkan lebih banyak kuota. |
| 503 | AGEN API TIDAK TERHUBUNG | Agen yang mengelola basis data Anda sedang offline. Periksa di bawah Data → Agen Data; panggilan akan berhasil kembali segera setelah terhubung kembali. |
| 504 | API_QUERY_TIMEOUT | Kueri tersebut membutuhkan waktu lebih dari 60 detik. Tambahkan filter atau indeks, atau simpan kueri yang lebih spesifik. |
Setiap badan kesalahan memiliki bentuk {"kesalahan": {"kode": "…", "pesan": "…"}} dan setiap respons membawa sebuah ID Permintaan X-QS Header. Kutip ID saat Anda menghubungi dukungan.
Pertanyaan yang diajukan orang
Apakah data saya disalin ke Query Streams?
Tidak. Agen menjalankan kueri di tempat data Anda berada dan hanya mengirimkan baris yang diminta oleh panggilan tersebut. Tidak ada yang disinkronkan atau di-cache di antaranya; setiap panggilan menjalankan kueri tersebut.
Apakah penelepon dapat mengubah SQL atau meminta tabel lain?
Tidak. Sebuah endpoint menjalankan satu query yang tersimpan. Pemanggil hanya dapat mengatur parameter yang telah Anda tandai. Dapat dipanggil, dan nilai-nilai tersebut diikat dengan aman: teks diberi tanda kutip dan di-escape, angka diperiksa rentangnya, daftar diperluas.
Bagaimana cara saya menyerahkan ini kepada rekan kerja?
Pada titik akhir Berbagi tab pilih Rakyat dan masukkan email mereka. Mereka mendapatkan tautan ajaib, masuk dengan alamat tersebut (akun gratis pun tidak masalah) dan membuat kunci mereka sendiri; Anda dapat melihat panggilan mereka berdasarkan nama di tab Aktivitas. Untuk server atau alat otomatisasi, buatlah sebuah Kunci API dengan label sebagai gantinya.
Apa yang terjadi ketika saya mengedit kueri yang tersimpan?
Endpoint menjalankan SQL baru pada panggilan berikutnya dan spesifikasi OpenAPI-nya dibuat ulang. URL dan kuncinya tidak berubah. Jika Anda menambahkan atau menghapus filter, tinjau kembali. Kunci parameter sehingga penelepon melihat parameter yang tepat.
Apakah paket gratis benar-benar mencakup hal ini?
Ya. Paket gratis adalah paket permanen, bukan uji coba yang akan berakhir. Paket ini mencakup satu endpoint, dua kunci, dan 250 baris per panggilan. Lihat detail lengkapnya di halaman berikut. halaman harga.
Apa perbedaannya dengan PostgREST, Hasura, atau DreamFactory?
Hal itu mengekspos skema Anda sebagai API dan Anda yang menghostingnya. Di sini, satu kueri yang tersimpan adalah satu titik akhir, SQL dan skema tetap bersifat pribadi, dan tidak ada yang perlu dihosting: Agen yang sudah Anda jalankan mengeksekusi kueri dan api.querystreams.com menyediakan HTTP, kunci, batasan laju, dan buku besar.
Bisakah satu endpoint menggabungkan data dari dua basis data?
Ya. Simpan kueri terfederasi (lintas sumber) di Query Builder dan ekspos; endpoint terfederasi berjalan dalam mode Statis.
Bisakah saya melakukan streaming hasil yang besar?
Memilih Mengalir Sebagai mode respons saat Anda membuat endpoint. Baris tiba sebagai NDJSON atau CSV dalam potongan hingga batas baris streaming paket Anda, dengan baris ringkasan di bagian akhir.
Panduan terkait
Mengalami masalah saat pengaturan?
- Agen menunjukkan Offline, atau Uji koneksi dan Jelajahi berwarna abu-abu? Periksa apakah Agen sedang online → Apakah agennya sedang online?

