Service Doc untuk Agen AI

Dokumentasi API & Akses Agen

Halaman ini target header Link: </docs/api/>; rel="service-doc". Semua endpoint mesin-terbaca di bawah gratis, tanpa API key untuk baca publik. Registrasi agen: /auth.md.

Endpoint

• /.well-known/api-catalog

  Indeks seluruh resource mesin-terbaca (RFC 9727 linkset, JSON).

• /.well-known/ai-catalog.json

  Manifes kapabilitas ARD: MCP server, API, skills, docs (JSON + CORS *).

• /.well-known/agent-skills/index.json

  Indeks Agent Skills Discovery (nama, deskripsi, URL, digest sha256).

• /.well-known/mcp/server-card.json

  Kartu MCP Server (SEP-1649). Endpoint tool: /api/mcp/ (POST JSON-RPC).

• /api/agent/openapi.json

  Spesifikasi OpenAPI 3.1 endpoint baca-publik.

• /api/status.json

  Health endpoint + jumlah entri katalog live.

• /api/agent/identity.json, /api/agent/claim.json, /api/agent/revoke.json

  Registrasi agen anonim + claim ceremony + revokasi (POST JSON).

• /.well-known/agent.json

  Deskripsi situs + ringkasan katalog kluster: nama, harga mulai (IDR), cicilan KPR, URL. Cache 1 jam.

• /api/markdown/?path=/

  Representasi markdown halaman. Beranda bernegosiasi otomatis: kirim Accept: text/markdown ke / dan respons memakai Content-Type: text/markdown + x-markdown-tokens. Halaman lain: panggil endpoint ini dengan ?path=.

• /.well-known/oauth-protected-resource

  Metadata OAuth Protected Resource (RFC 9728): resource, authorization servers, scope.

• /.well-known/oauth-authorization-server

  Metadata authorization server (RFC 8414) + blok agent_auth untuk registrasi agen.

• /.well-known/openid-configuration

  Discovery OpenID Connect 1.0 (issuer, endpoints, grants).

• /.well-known/agent-skills/bintaro-catalog/SKILL.md

  Instruksi pemakaian katalog untuk agen AI (markdown).

Tool browser (WebMCP)

Setiap halaman mendaftarkan tool cari_kluster, info_promo, dan hubungi_sales via navigator.modelContext.registerTool().