API AI & MCP

API key dan rate limit

Endpoint di halaman ini tidak bisa dipakai tanpa kunci akses yang valid.

Header yang dipakai saat ini adalah X-API-Key.
Jika API key tidak dikirim atau tidak valid, backend akan mengembalikan status 401.
Header rate limit tersedia di response, termasuk x-ratelimit-limit.
Batas saat ini: 30 request per menit untuk tier biasa dan 120 request per menit untuk tier enterprise.

GET /api/ai/recommend

Endpoint ini dipakai untuk mencari kandidat provider lewat query bahasa alami.

Autentikasi: wajib X-API-Key.
Query wajib: q.
Query opsional: city, limit.
Validasi: q minimal 2 karakter, maksimal 200 karakter, dan limit dibatasi 1 sampai 10.

GET /api/ai/recommend?q=web%20development&city=Jakarta&limit=5
X-API-Key: qelar_live_xxx

{
  "data": [
    {
      "slug": "acme-studio",
      "reason": "Ranked by hybrid retrieval (keyword + vector) with Reciprocal Rank Fusion (RRF)."
    }
  ],
  "meta": {
    "q": "web development",
    "city": "Jakarta",
    "total": 1,
    "limit": 5,
    "source": "hybrid"
  }
}

POST /mcp

Endpoint ini dipakai untuk integrasi alat berbasis JSON-RPC. Endpoint ini bukan untuk dibuka langsung di browser.

Autentikasi: mengikuti API key middleware yang sama.
Format request: JSON-RPC.
Alat yang aktif saat ini: search_providers, get_provider_card, dan compare_providers.
Fungsi endpoint ini adalah menjembatani penggunaan QELAR oleh alat eksternal, bukan menggantikan REST API publik.

POST /mcp
X-API-Key: qelar_live_xxx
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/list"
}

{
  "tools": [
    "search_providers",
    "get_provider_card",
    "compare_providers"
  ]
}