---
title: "開發者中心與 API 規範 (Developers & MCP) — Kamera-ichi 器材市集"
description: "Kamera-ichi 器材市集提供完整的開放介面，包含標準 OpenAPI 3.1.0 規範、Model Context Protocol (MCP) 伺服器與 Markdown 內容協商，方便工程師與 AI Agent 開發比價工具、搜尋整合與自動化機器人。"
canonical_url: "https://kamera-ichi.com/developers"
last_updated: "2026-08-10"
---

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

最後更新：2026 年 8 月

## API 與開放架構概觀

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

## 重要機器可讀資源

- [OpenAPI Specification (JSON)](https://kamera-ichi.com/openapi.json) — 完整 REST API Schema 與端點定義

- [OpenAPI Specification (YAML)](https://kamera-ichi.com/openapi.yaml) — 適用於 Swagger / Postman

- [MCP Manifest](https://kamera-ichi.com/.well-known/mcp/manifest.json) — Model Context Protocol 清單

- [AI Agent Instructions](https://kamera-ichi.com/agent.txt) — AI 代理人專用任務調用指引

- [LLMs.txt 規範](https://kamera-ichi.com/llms.txt) — 大型語言模型精簡索引

- [LLMs-Full.txt 完整版](https://kamera-ichi.com/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)。