{"name":"詔安里長小黃瓜商店 API","version":"1.0.0","description":"這是程大源的詔安里長小黃瓜商店。價格：每公斤 $80，最低購買 5 公斤，運費 $130。其他 AI agent 可以透過此 API 查詢商品、取得訂單、或直接下單。","authentication":"部分端點需要 ?api_key=... 參數（由 SHOP_API_KEY 環境變數設定）。","endpoints":{"GET /api/products":"取得所有商品清單","GET /api/products/{id}":"取得單一商品詳細資訊","POST /api/chat":{"description":"AI 對話端點。會用 AI 銷售助手回覆客戶，支援 function calling（詢價、計算、下單）。","request_body":{"messages":[{"role":"user","content":"我想買小黃瓜"},{"role":"assistant","content":"好的！我們有以下商品..."}]},"response":{"reply":"AI 回覆文字","messages":"完整對話歷史（含 function call 結果），可用於下一輪請求"},"note":"其他 AI agent 可以直接串接此端點。也支援 MCP SSE：/mcp/sse（見 /api/docs）。"},"POST /api/orders":{"description":"直接下單（不經對話流程，適合 AI 自動下單）","request_body":{"customer_name":"姓名","customer_contact":"電話或 Line ID","recipient_name":"收件人姓名","recipient_phone":"收件人電話","items":[{"product_id":"cucumber-5kg","quantity":1}],"shipping_address":"收件地址","notes":"備註（選填）"}},"GET /api/orders":"查詢所有訂單（需 api_key）","GET /api/orders/{id}":"查詢單筆訂單（需 api_key）"},"MCP Server":{"description":"支援 MCP 協定（Model Context Protocol），Claude、Cursor、Codex 等可直接連接。","endpoint":"GET /mcp/sse（SSE 連線），POST /mcp/messages/（訊息交換）","tools":"list_products, get_product, get_market_price, calculate_order, place_order, confirm_order"},"example_curl":{"查商品":"curl https://cucumber-ai-shop.zeabur.app/api/products","AI 對話":"curl -X POST https://cucumber-ai-shop.zeabur.app/api/chat -H \"Content-Type: application/json\" -d '{\"messages\": [{\"role\": \"user\", \"content\": \"你們有什麼小黃瓜？\"}]'","直接下單":"curl -X POST https://cucumber-ai-shop.zeabur.app/api/orders -H \"Content-Type: application/json\" -d '{\"customer_name\": \"王小明\", \"customer_contact\": \"0912345678\", \"recipient_name\": \"王大明\", \"recipient_phone\": \"0987654321\", \"items\": [{\"product_id\": \"cucumber-5kg\", \"quantity\": 1}],  # 1 件 = 1 箱 \"shipping_address\": \"台北市大安區...\"}'"}}