Developer resources
Public agent and knowledge interfaces
Start here
kaucim.ai publishes a small public interface for AI retrieval and user-approved agent purchases. It does not expose admin, analytics, private reading, or payment-card APIs. The machine-readable contract is the OpenAPI 3.1 document.
curl https://www.kaucim.ai/api/products.jsonRead-only knowledge endpoints
| Method | Path | Purpose |
|---|---|---|
GET | /api/ai-profile.json | Versioned site-wide knowledge profile |
GET | /api/products.json | Current products, locales, routes, pricing sources, and limits |
GET | /api/article-md/{lang}/{slug} | One published article as Markdown |
GET | /api/product-md/{lang}/{product} | One supported product summary as Markdown |
GET | /api/llms-full/{lang} | A locale article corpus as Markdown |
GET | /api/llms-index/{lang} | The concise locale site index as Markdown |
These endpoints require no API key. Product facts include their own schema version, review date, source files, and cache policy. Prices must be read from the stated source or current catalog rather than copied into long-lived prompts.
Agent purchases
Read the agent product catalog, collect only the fields declared by the selected item's input_schema, then call POST /api/agent/checkout/{product_id}. Give the returned hosted payment URL to the user. The user completes payment; an agent must never enter or retain card details on the user's behalf.
Where a report endpoint is declared, poll GET /api/agent/report/{session_id} after payment. Some catalog products deliver on a result page instead, and the catalog is authoritative for that distinction.
Errors and recovery
The public knowledge endpoints and unknown public API routes return structured application/problem+json errors with a stable code, human-readable detail, and a concrete resolution. Markdown endpoints return text/markdown; charset=utf-8 on success. Agent-commerce endpoints use their documented JSON status and error fields for backward compatibility.
Usage boundaries
- Use public content and documented endpoints only.
- Do not send private result URLs, credentials, or card details to these interfaces.
- Do not present cultural reflection as medical, legal, financial, safety, or deterministic advice.
- Respect the product catalog's language, input, pricing, and availability fields.
Questions and responsible-disclosure reports can be sent through the contact page.