API Connect

API Connect adalah service HTTP proxy RAGA, dibangun di atas Node.js + Express. Service ini menerima konfigurasi koneksi API dan endpoint lewat request body, menangani otentikasi (Basic, Bearer, atau JWT auto-login), lalu meneruskan request ke API eksternal dan mengembalikan responsnya apa adanya.

API Connect dipanggil oleh API Tarantula sebagai pelaksana panggilan untuk fitur Text-to-API — permintaan yang dihasilkan LLM diteruskan lewat service ini ke API eksternal yang dikonfigurasi user di workspace, tanpa perlu menyimpan kredensial API tersebut di server manapun.

API Connect bersifat stateless — tidak ada konfigurasi API yang disimpan di service ini. Semua kredensial dan detail endpoint dikirim oleh caller di dalam request body setiap kali.

Tech Stack

Komponen	Teknologi
Runtime	Node.js 18
Framework	Express 4
HTTP Client	axios
API Docs	swagger-ui-express + swagger-jsdoc (/api-docs)

Detail endpoint, mode otentikasi, dan diagram alur lengkap ada di halaman Teknis.

Cara Kerja Singkat

1. Caller mengirim POST /proxy dengan objek connection berisi host, auth, dan endpoint (path, method, params/body) tujuan.
2. API Connect menyiapkan header otentikasi sesuai auth.type: Basic (base64 user:password), Bearer (token langsung), atau JWT (login otomatis ke loginPath untuk mengambil token terlebih dahulu).
3. Request diteruskan ke API eksternal lewat axios sesuai method HTTP (GET/HEAD pakai query params, method lain pakai body).
4. Response dari API target diteruskan apa adanya (pass-through) ke caller.

Ringkasan

API Connect adalah jembatan tipis dan stateless antara Raga Engine dan API eksternal mana pun yang dikonfigurasi user — mirip perannya dengan Database Connect untuk RDBMS, tapi untuk Text-to-API: menangani kompleksitas otentikasi (termasuk auto-login JWT) supaya konfigurasi API eksternal tetap fleksibel per workspace tanpa hardcoding di server.