開發者中心與 API 規範 (Developers & MCP) — Kamera-ichi 器材市集

API 與開放架構概觀

Kamera-ichi 器材市集提供完整的開放介面，包含標準 OpenAPI 3.1.0 規範、Model Context Protocol (MCP) 伺服器與 Markdown 內容協商，方便工程師與 AI Agent 開發比價工具、搜尋整合與自動化機器人。

重要機器可讀資源

• OpenAPI Specification (JSON) — 完整 REST API Schema 與端點定義
• OpenAPI Specification (YAML) — 適用於 Swagger / Postman
• MCP Manifest — Model Context Protocol 清單
• AI Agent Instructions — AI 代理人專用任務調用指引
• LLMs.txt 規範 — 大型語言模型精簡索引
• LLMs-Full.txt 完整版 — 完整平台知識庫

支援之核心 API 端點

• GET /api/listings/search：依關鍵字、分類、品牌、預算、地區搜尋商品。
• GET /api/trends/{brand}/{model}：查詢特定相機或鏡頭型號的二手均價與走勢。
• GET /api/listings/{id}：取得單筆商品規格、照片與賣家資訊。
• POST /api/mcp：Model Context Protocol JSON-RPC 2.0 串流端點。

速率限制與錯誤格式

API 預設每分鐘限制 100 次請求，所有回應均帶標準 RFC RateLimit 與 Vary 標頭。錯誤回應一律回傳結構化 JSON，包含錯誤代碼、詳細訊息與修復提示 (Hint)。