{"components":{"schemas":{"Error":{"properties":{"error":{"type":"string"},"ok":{"type":"boolean"}},"type":"object"},"Product":{"properties":{"category":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"description":{"type":"string"},"id":{"type":"integer"},"images":{"items":{"type":"string"},"type":"array"},"location":{"type":"string"},"price":{"type":"number"},"seller_name":{"type":"string"},"title":{"description":"\u5546\u54c1\u6807\u9898","type":"string"}},"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"description":"API Key\u3002\u5199\u64cd\u4f5c\u5fc5\u9700\uff0c\u8bfb\u64cd\u4f5c\u516c\u5f00\u3002","in":"header","name":"X-API-Key","type":"apiKey"}}},"info":{"contact":{"name":"\u5149\u5c18\u9601","url":"https://xinxi.zxwsh.com"},"description":"\u949f\u7965\u4fe1\u606f\u5e73\u53f0 JSON RESTful API \u2014 \u5546\u54c1/\u7528\u6237/\u8ba2\u5355/\u793e\u533a\u5168\u529f\u80fd\u3002\u4e3a AI Agent\u3001\u5927\u6a21\u578b\u5de5\u5177\u3001\u7b2c\u4e09\u65b9\u5f00\u53d1\u8005\u63d0\u4f9b\u6807\u51c6\u5316\u6570\u636e\u51fa\u53e3\u3002","title":"\u5149\u5c18\u9601\u4fe1\u606f\u5e73\u53f0 API","version":"2.0.0"},"openapi":"3.0.3","paths":{"/api/v1/":{"get":{"description":"\u8fd4\u56de\u6240\u6709\u53ef\u7528\u7aef\u70b9\u548c\u6587\u6863\u94fe\u63a5","responses":{"200":{"description":"API \u7d22\u5f15"}},"summary":"API \u7d22\u5f15"}},"/api/v1/ai/feed":{"get":{"description":"\u4e3a AI Agent \u548c\u5927\u6a21\u578b\u4f18\u5316\u7684\u5185\u5bb9\u6458\u8981\u7aef\u70b9\uff0c\u652f\u6301 JSON/JSON-LD/Markdown \u683c\u5f0f","parameters":[{"in":"query","name":"format","schema":{"enum":["json","jsonld","markdown"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":50,"type":"integer"}},{"in":"query","name":"category","schema":{"type":"string"}}],"responses":{"200":{"description":"\u7ed3\u6784\u5316\u5185\u5bb9\u6458\u8981"}},"summary":"AI \u5185\u5bb9\u6458\u8981\u6d41"}},"/api/v1/categories":{"get":{"description":"\u8fd4\u56de\u6240\u6709\u4e00\u7ea7\u5206\u7c7b\u53ca\u5176\u5b50\u5206\u7c7b\uff0846\u4e2a\u4e00\u7ea7\u5206\u7c7b\uff09","responses":{"200":{"description":"\u5206\u7c7b\u6811 JSON"}},"summary":"\u5206\u7c7b\u6811"}},"/api/v1/community/posts":{"get":{"parameters":[{"in":"query","name":"category","schema":{"enum":["general","question","sharing","event","\u4e09\u519c"],"type":"string"}},{"in":"query","name":"q","schema":{"type":"string"}},{"in":"query","name":"sort","schema":{"enum":["newest","hot"],"type":"string"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"size","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"description":"\u5e16\u5b50\u5217\u8868"}},"summary":"\u793e\u533a\u5e16\u5b50\u5217\u8868"},"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"category":{"enum":["general","question","sharing","event","\u4e09\u519c"],"type":"string"},"content":{"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"}},"required":["title","content"],"type":"object"}}},"required":true},"responses":{"201":{"description":"\u53d1\u5e16\u6210\u529f"}},"security":[{"ApiKeyAuth":[]}],"summary":"\u53d1\u5e16"}},"/api/v1/community/posts/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"\u5e16\u5b50\u5b8c\u6574\u4fe1\u606f+\u8bc4\u8bba\u5217\u8868"}},"summary":"\u5e16\u5b50\u8be6\u60c5\uff08\u542b\u8bc4\u8bba\uff09"}},"/api/v1/community/posts/{id}/comments":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"content":{"type":"string"},"parent_id":{"type":"integer"}},"required":["content"],"type":"object"}}},"required":true},"responses":{"201":{"description":"\u8bc4\u8bba\u6210\u529f"}},"summary":"\u53d1\u8868\u8bc4\u8bba"}},"/api/v1/orders":{"get":{"parameters":[{"in":"query","name":"role","schema":{"enum":["buyer","seller","all"],"type":"string"}},{"in":"query","name":"status","schema":{"type":"string"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"size","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"description":"\u8ba2\u5355\u5217\u8868"},"401":{"description":"\u672a\u767b\u5f55"}},"summary":"\u6211\u7684\u8ba2\u5355\u5217\u8868"},"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"amount":{"type":"number"},"buyer_note":{"type":"string"},"product_id":{"type":"integer"}},"required":["product_id"],"type":"object"}}},"required":true},"responses":{"201":{"description":"\u521b\u5efa\u6210\u529f"},"401":{"description":"\u672a\u767b\u5f55"}},"summary":"\u521b\u5efa\u8ba2\u5355"}},"/api/v1/orders/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"\u8ba2\u5355\u5b8c\u6574\u4fe1\u606f"}},"summary":"\u8ba2\u5355\u8be6\u60c5"},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"status":{"enum":["paid","shipped","received","completed","cancelled"],"type":"string"}},"required":["status"],"type":"object"}}}},"responses":{"200":{"description":"\u72b6\u6001\u66f4\u65b0\u6210\u529f"}},"summary":"\u66f4\u65b0\u8ba2\u5355\u72b6\u6001"}},"/api/v1/products":{"get":{"description":"\u5206\u9875\u83b7\u53d6\u5546\u54c1\u5217\u8868\uff0c\u652f\u6301\u5206\u7c7b/\u5730\u70b9/\u4ef7\u683c\u7b5b\u9009","parameters":[{"in":"query","name":"category","schema":{"type":"string"}},{"in":"query","name":"location","schema":{"type":"string"}},{"in":"query","name":"min_price","schema":{"type":"number"}},{"in":"query","name":"max_price","schema":{"type":"number"}},{"in":"query","name":"sort","schema":{"enum":["newest","price_asc","price_desc"],"type":"string"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"size","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"description":"\u5546\u54c1\u5217\u8868\uff0c\u542b\u5206\u9875"}},"summary":"\u5546\u54c1\u5217\u8868"},"post":{"description":"\u521b\u5efa\u65b0\u5546\u54c1\uff08\u9700 API Key\uff09","requestBody":{"content":{"application/json":{"schema":{"properties":{"category":{"type":"string"},"description":{"type":"string"},"images":{"items":{"type":"string"},"type":"array"},"location":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["title","price","category"],"type":"object"}}},"required":true},"responses":{"201":{"description":"\u521b\u5efa\u6210\u529f"},"400":{"description":"\u53c2\u6570\u9519\u8bef"}},"security":[{"ApiKeyAuth":[]}],"summary":"\u53d1\u5e03\u5546\u54c1"}},"/api/v1/products/{id}":{"delete":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"\u5220\u9664\u6210\u529f"}},"security":[{"ApiKeyAuth":[]}],"summary":"\u5220\u9664\u5546\u54c1"},"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"\u5546\u54c1\u5b8c\u6574\u4fe1\u606f"}},"summary":"\u5546\u54c1\u8be6\u60c5"},"put":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"\u66f4\u65b0\u6210\u529f"}},"security":[{"ApiKeyAuth":[]}],"summary":"\u66f4\u65b0\u5546\u54c1"}},"/api/v1/search":{"get":{"description":"\u641c\u7d22\u5546\u54c1\u6807\u9898\u3001\u63cf\u8ff0\uff0c\u652f\u6301\u5206\u7c7b/\u5730\u70b9/\u4ef7\u683c\u7b5b\u9009\u548c\u76f8\u5173\u6027\u6392\u5e8f","parameters":[{"description":"\u641c\u7d22\u5173\u952e\u8bcd","in":"query","name":"q","schema":{"type":"string"}},{"description":"\u5206\u7c7b\u7b5b\u9009","in":"query","name":"category","schema":{"type":"string"}},{"description":"\u5730\u70b9\u7b5b\u9009","in":"query","name":"location","schema":{"type":"string"}},{"description":"\u6700\u4f4e\u4ef7","in":"query","name":"min_price","schema":{"type":"number"}},{"description":"\u6700\u9ad8\u4ef7","in":"query","name":"max_price","schema":{"type":"number"}},{"in":"query","name":"sort","schema":{"enum":["relevance","newest","price_asc","price_desc"],"type":"string"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"size","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"description":"\u641c\u7d22\u7ed3\u679c\uff0c\u542b\u5206\u9875"}},"summary":"\u5168\u6587\u641c\u7d22"}},"/api/v1/users":{"get":{"parameters":[{"in":"query","name":"q","schema":{"type":"string"}},{"in":"query","name":"sort","schema":{"enum":["trust_score","newest","trade_count"],"type":"string"}},{"in":"query","name":"verified_only","schema":{"enum":["0","1"],"type":"string"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"size","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"description":"\u7528\u6237\u5217\u8868"}},"summary":"\u7528\u6237\u5217\u8868"}},"/api/v1/users/me":{"get":{"description":"\u83b7\u53d6\u5df2\u767b\u5f55\u7528\u6237\u7684\u5b8c\u6574\u8d44\u6599\uff08\u9700 session \u767b\u5f55\uff09","responses":{"200":{"description":"\u7528\u6237\u5b8c\u6574\u8d44\u6599"},"401":{"description":"\u672a\u767b\u5f55"}},"summary":"\u5f53\u524d\u7528\u6237\u8d44\u6599"},"put":{"description":"\u66f4\u65b0\u5f53\u524d\u7528\u6237\u7684 display_name/phone/wechat_id/location/avatar","responses":{"200":{"description":"\u66f4\u65b0\u6210\u529f"},"401":{"description":"\u672a\u767b\u5f55"}},"summary":"\u66f4\u65b0\u4e2a\u4eba\u8d44\u6599"}},"/api/v1/users/{username}":{"get":{"parameters":[{"in":"path","name":"username","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\u7528\u6237\u516c\u5f00\u8d44\u6599+\u7edf\u8ba1"}},"summary":"\u7528\u6237\u8d44\u6599"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"description":"\u5f53\u524d\u670d\u52a1\u5668","url":"https://xinxi.zxwsh.com"}]}