{"name":"詔安里長優質小黃瓜 API","version":"1.0.0","description":"詔安里長優質小黃瓜，無農藥栽培。價格依花胡瓜市場上價均值 +10% 每日浮動，最低 5 公斤，運費 $130~$210（依總公斤數分級）。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"},"Facebook Messenger":{"description":"粉絲專頁 AI 客服。訪客傳送 Messenger 訊息到「詔安里里長程大源」粉專 → AI 自動回覆引導下單。","webhook":"GET/POST /fb/webhook","setup":"需設定 FB_PAGE_ACCESS_TOKEN、FB_APP_SECRET、FB_VERIFY_TOKEN 環境變數"},"LINE Messaging":{"description":"LINE 官方帳號 AI 客服。加入好友後傳訊息即可詢價下單。","webhook":"POST /line/webhook"},"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\": \"台北市大安區...\"}'"}}