Smart 145

Developer Portal

OpenAPI spec, agent skills, chat API, and markdown content negotiation for the Smart 145 Knowledge Base.

Integrate with the public Smart 145 Knowledge Base programmatically. This portal documents the HTTP APIs, agent skills, and content-negotiation conventions available on this site.

Quickstart

  1. Read the OpenAPI specification for endpoint schemas and rate limits.
  2. Load agent skills for structured browse and search workflows.
  3. Request any article URL with Accept: text/markdown to receive markdown instead of HTML.
  4. Optionally call POST /api/v1/chat/send for AI-assisted answers grounded in published articles.

API Endpoints

POST /api/v1/chat/send

Send a natural-language question and receive a markdown answer with article citations. Rate limit: 30 requests/minute. No authentication required.

curl -X POST https://knowledgebase.smart145.com/api/v1/chat/send \
  -H "Content-Type: application/json" \
  -d '{"message":"How do I create a repair order?"}'

GET /search?q={query}

Full-text search returning HTML results. Follow result links with markdown negotiation for article content.

GET /{topic}/{slug}

Retrieve a single article. Send Accept: text/markdown for markdown output.

Authentication

Public browse, search, and chat endpoints require no authentication. The cache-clear endpoint (/api/v1/cache/clear) requires a bearer token configured server-side as CACHE_CLEAR_TOKEN and is intended for operational use only.

Rate Limits

All endpoints return RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers. A 429 response includes Retry-After. See the OpenAPI spec for per-endpoint limits.

Resources