Dokumentasi/API/Ikhtisar API

Lihat URL dan endpoint publik yang dipakai QELAR.

Halaman ini merangkum URL publik, endpoint API, data terstruktur, dan aset distribusi yang aktif saat ini. Setiap endpoint di bawah mengacu ke implementasi yang memang sudah dipakai oleh produk.

IkhtisarProviderPencarian & discoveryAI & MCPVIC & data publik

Cakupan halaman ini

Di QELAR, permukaan publik tidak hanya berupa endpoint `api/v1`. Ada juga halaman provider, VIC, `llms.txt`, dan kumpulan sitemap yang dipakai crawler serta sistem AI untuk membaca data produk.

  • URL publik dan endpoint API dibedakan agar pembaca tahu mana yang dibuka manusia dan mana yang dibaca sistem.
  • Setiap endpoint di halaman ini sudah ada implementasinya di aplikasi web atau backend.
  • Data terstruktur dan metadata tetap dianggap bagian dari acuan publik karena menentukan cara sistem eksternal memahami isi halaman.
  • Halaman ini hanya merangkum endpoint yang aktif. Detail field dan respons dibahas lagi di halaman referensi yang lebih rinci.

URL publik yang aktif

Ini adalah URL publik yang sudah menjadi bagian dari produk. Beberapa di antaranya dibaca langsung oleh pengguna, sementara yang lain dipakai crawler, search engine, atau sistem AI.

Halaman provider

Halaman publik utama untuk identitas bisnis, layanan, rekam jejak, dan tanda kepercayaan.
GEThttps://www.qelar.com/provider/{slug}

VIC provider

Output JSON-LD untuk Provider Intelligence Card yang dipakai mesin pencari dan sistem AI saat membaca data publik provider.
GEThttps://www.qelar.com/provider/{slug}/vic.json

llms.txt

Petunjuk publik untuk sistem AI tentang data dan dokumen QELAR yang tersedia.
GEThttps://www.qelar.com/llms.txt

Sitemap utama

Daftar sitemap utama untuk halaman provider dan VIC.
GEThttps://www.qelar.com/sitemap.xml

Sitemap provider

Daftar halaman provider yang sudah tayang.
GEThttps://www.qelar.com/sitemap-providers.xml

VIC sitemap

Daftar endpoint VIC yang sudah tayang.
GEThttps://www.qelar.com/sitemap-vic.xml

Sitemap kategori

Daftar URL kategori dan subkategori direktori yang aktif di web.
GEThttps://www.qelar.com/sitemap-taxonomy.xml

Endpoint API publik yang aktif

Daftar ini merangkum endpoint publik yang tersedia dari backend saat ini. Semua endpoint di bawah sudah dipakai oleh aplikasi web, halaman publik, atau integrasi sistem lain di dalam produk.

Kategori

Mengembalikan kategori aktif beserta hierarki parent dan child.
GEThttps://api.qelar.com/api/v1/categories

Daftar provider

Daftar provider yang sudah tayang dengan filter `city`, `country`, `minTrustLevel`, `page`, `limit`, dan `sort`.
GEThttps://api.qelar.com/api/v1/providers

Detail provider

Mengembalikan ringkasan satu provider yang sudah tayang.
GEThttps://api.qelar.com/api/v1/providers/{slug}

Pencarian

Pencarian provider dengan filter tambahan seperti `city`, `categorySlug`, `minTrustLevel`, `minRating`, `industry`, dan `sort`.
GEThttps://api.qelar.com/api/v1/search?q={query}

Laporan benchmark

Laporan benchmark publik yang dipakai di halaman laporan.
GEThttps://api.qelar.com/api/v1/reports/benchmark-web-development-indonesia-2026

Parameter discovery programatik

Daftar parameter untuk membangun halaman discovery programatik.
GEThttps://api.qelar.com/api/v1/discovery/programmatic-params

Discovery programatik

Daftar provider per kombinasi kategori dan kota.
GEThttps://api.qelar.com/api/v1/discovery/programmatic?categorySlug={slug}&citySlug={slug}

Perbandingan provider

Perbandingan dua provider yang sudah tayang.
GEThttps://api.qelar.com/api/v1/discovery/compare?slugA={slug}&slugB={slug}

Rekomendasi AI

Endpoint rekomendasi AI yang dilindungi API key, mendukung `limit`, dan dibatasi per tier.
GEThttps://api.qelar.com/api/ai/recommend?q={query}&city={kota}

MCP endpoint

Endpoint MCP untuk alat seperti `search_providers`, `get_provider_card`, dan `compare_providers`.
POSThttps://api.qelar.com/mcp

MCP info endpoint

Endpoint ringan untuk pemeriksaan manusia dan health-check dasar MCP tanpa memanggil tool.
GEThttps://api.qelar.com/mcp
  • Endpoint `api/v1` ditujukan untuk konsumsi publik dan aplikasi web.
  • Endpoint `api/ai/recommend` memerlukan API key, query minimal 2 karakter, query maksimal 200 karakter, dan `limit` dibatasi 1 sampai 10.
  • Pembatasan laju akses `api/ai/recommend` saat ini adalah 30 request per menit untuk tier biasa dan 120 request per menit untuk tier enterprise.
  • `POST /mcp` memakai JSON-RPC dan disediakan untuk integrasi alat, bukan untuk dibuka langsung oleh pembaca biasa.
  • `GET /mcp` tersedia sebagai endpoint ringan untuk melihat info dasar layanan MCP dan health-check manusia.
  • Jika detail request atau respons berubah, halaman ini harus ikut diperbarui bersama perubahan endpoint di source code.

Reference per kelompok endpoint

Gunakan halaman-halaman di bawah ini untuk membaca detail endpoint dengan lebih rinci. Halaman ikhtisar tetap dipakai untuk peta umum, sedangkan halaman detail dipakai saat Anda mulai mengintegrasikan endpoint tertentu.

API provider

Rujukan untuk kategori aktif, daftar provider, detail provider, dan bentuk field ringkas yang dipakai listing publik.

Buka halaman detail

API pencarian & discovery

Rujukan untuk search, discovery programatik, perbandingan provider, error penting, dan konteks hasil perbandingan.

Buka halaman detail

API AI & MCP

Rujukan untuk `api/ai/recommend`, kebutuhan API key, rate limit, dan endpoint MCP berbasis JSON-RPC.

Buka halaman detail

VIC & data publik

Rujukan untuk VIC, `llms.txt`, sitemap, taxonomy sitemap, content type, dan header penting di permukaan publik.

Buka halaman detail

Data terstruktur dan metadata

Data terstruktur dan metadata mengubah konten halaman menjadi bentuk yang lebih stabil untuk diindeks. Nilainya bukan hanya untuk SEO. Lapisan ini menjaga agar identitas bisnis, layanan, dan tanda kepercayaan tetap terbaca lintas keluaran data.

  • Judul halaman, metadata, dan isi utama harus menyampaikan fakta yang sama.
  • VIC dan data terstruktur tidak boleh mengklaim lebih dari yang tampil di halaman publik.
  • Kalau halaman publik berubah, output data untuk sistem harus ikut diperbarui dari sumber data yang sama.

llms.txt, sitemap, dan aset distribusi

Aset distribusi membantu QELAR menyampaikan peta konten dan prioritas entity ke sistem crawler. Mereka bukan pengganti halaman utama, tetapi lapisan pendukung agar halaman yang penting lebih mudah ditemukan dan dipahami.

  • `sitemap` membantu crawler menemukan URL yang perlu diprioritaskan.
  • `llms.txt` membantu sistem AI memahami entry point dan konteks dokumen yang tersedia.
  • `sitemap-taxonomy.xml` membantu crawler menemukan URL kategori dan subkategori direktori yang aktif.
  • Aset distribusi bernilai hanya jika halaman targetnya sendiri cukup jelas dan substantif.