Transport & Endpoints
kalam-link wraps transport details, but understanding endpoint mapping helps debugging, tracing, and ops instrumentation.
Base URL
http://localhost:8080HTTP Endpoints Used By SDK
| Method | Path | Used by |
|---|---|---|
POST | /v1/api/sql | query, queryWithFiles, convenience DML |
POST | /v1/api/auth/login | login() |
POST | /v1/api/auth/refresh | refreshToken() |
GET | /v1/api/healthcheck | health checks/tooling |
WebSocket Endpoint
| Method | Path | Used by |
|---|---|---|
GET | /v1/ws | connect, subscribe, subscribeWithSql |
Method-To-Transport Mapping
| SDK Method | Transport |
|---|---|
query() | WASM client -> HTTP POST /v1/api/sql |
queryWithFiles() | direct multipart HTTP POST /v1/api/sql |
queryOne() / queryAll() | wrapper over query() + local row parsing |
insert() / update() / delete() | WASM client SQL helpers via POST /v1/api/sql |
executeAsUser() | wrapper that rewrites SQL then calls query() |
login() | WASM client -> HTTP POST /v1/api/auth/login |
refreshToken() | WASM client -> HTTP POST /v1/api/auth/refresh |
connect() | WebSocket handshake GET /v1/ws |
subscribeWithSql() | WebSocket subscription stream |
consumeBatch() | WASM topic consume API |
ack() | WASM topic ack API |
Connection Flow
- create client with
Auth.basic,Auth.jwt, orAuth.none - optional
login()to exchange basic credentials for JWT connect()opens WebSocket sessionsubscribeWithSql()registers live query streamquery()andqueryWithFiles()run over HTTP
References
Last updated on