{"openapi":"3.1.0","info":{"title":"西城成交档案只读查询 API","version":"1.1.0","description":"公开、只读、参数化的成交记录组合查询。支持 GET 查询参数与 POST JSON；不会执行调用方提供的 SQL。多房源原图会为每条记录返回独立裁图 imageUrl，并通过 originalImageUrl 保留完整原图。"},"servers":[{"url":"https://hotel.xbrain.site"}],"paths":{"/api/query":{"get":{"operationId":"queryTransactionsByParameters","summary":"使用 URL 参数组合查询成交记录","parameters":[{"name":"keyword","in":"query","required":false,"schema":{"type":["string","null"],"maxLength":100}},{"name":"community","in":"query","required":false,"schema":{"type":["string","null"],"maxLength":100}},{"name":"district","in":"query","required":false,"schema":{"type":["string","null"],"maxLength":60}},{"name":"school","in":"query","required":false,"schema":{"type":["string","null"],"maxLength":100}},{"name":"orientation","in":"query","required":false,"schema":{"type":["string","null"],"maxLength":40}},{"name":"floorBand","in":"query","required":false,"schema":{"type":["string","null"],"maxLength":20}},{"name":"reviewStatus","in":"query","required":false,"schema":{"type":["string","null"],"enum":["auto_verified","needs_review","sample-reviewed","unreviewed",null]}},{"name":"articleId","in":"query","required":false,"schema":{"type":["string","null"],"maxLength":100}},{"name":"startDate","in":"query","required":false,"schema":{"type":["string","null"],"format":"date"}},{"name":"endDate","in":"query","required":false,"schema":{"type":["string","null"],"format":"date"}},{"name":"bedrooms","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0,"maximum":30}},{"name":"livingRooms","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0,"maximum":20}},{"name":"bathrooms","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0,"maximum":20}},{"name":"minListPrice","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"maxListPrice","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"minPrice","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"maxPrice","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"minArea","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"maxArea","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"minUnitPrice","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"maxUnitPrice","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0}},{"name":"minNegotiation","in":"query","required":false,"schema":{"type":["number","null"],"minimum":-100,"maximum":100}},{"name":"maxNegotiation","in":"query","required":false,"schema":{"type":["number","null"],"minimum":-100,"maximum":100}},{"name":"minCycleDays","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0}},{"name":"maxCycleDays","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":0}},{"name":"minFloor","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":-10,"maximum":300}},{"name":"maxFloor","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":-10,"maximum":300}},{"name":"minFloorTotal","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":1,"maximum":300}},{"name":"maxFloorTotal","in":"query","required":false,"schema":{"type":["integer","null"],"minimum":1,"maximum":300}},{"name":"minConfidence","in":"query","required":false,"schema":{"type":["number","null"],"minimum":0,"maximum":1}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["newest","oldest","price-asc","price-desc","area-asc","area-desc","unit-asc","unit-desc","discount-asc","discount-desc","cycle-asc","cycle-desc"],"default":"newest"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":24}},{"name":"facets","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"设为 1 时返回可选片区、楼层类型和数据状态。"}],"responses":{"200":{"description":"分页成交记录或筛选项元数据"},"422":{"description":"查询参数无效"}}},"post":{"operationId":"queryTransactionsByJson","summary":"使用 JSON 组合查询成交记录","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":["string","null"],"maxLength":100},"community":{"type":["string","null"],"maxLength":100},"district":{"type":["string","null"],"maxLength":60},"school":{"type":["string","null"],"maxLength":100},"orientation":{"type":["string","null"],"maxLength":40},"floorBand":{"type":["string","null"],"maxLength":20},"reviewStatus":{"type":["string","null"],"enum":["auto_verified","needs_review","sample-reviewed","unreviewed",null]},"articleId":{"type":["string","null"],"maxLength":100},"startDate":{"type":["string","null"],"format":"date"},"endDate":{"type":["string","null"],"format":"date"},"bedrooms":{"type":["integer","null"],"minimum":0,"maximum":30},"livingRooms":{"type":["integer","null"],"minimum":0,"maximum":20},"bathrooms":{"type":["integer","null"],"minimum":0,"maximum":20},"minListPrice":{"type":["number","null"],"minimum":0},"maxListPrice":{"type":["number","null"],"minimum":0},"minPrice":{"type":["number","null"],"minimum":0},"maxPrice":{"type":["number","null"],"minimum":0},"minArea":{"type":["number","null"],"minimum":0},"maxArea":{"type":["number","null"],"minimum":0},"minUnitPrice":{"type":["number","null"],"minimum":0},"maxUnitPrice":{"type":["number","null"],"minimum":0},"minNegotiation":{"type":["number","null"],"minimum":-100,"maximum":100},"maxNegotiation":{"type":["number","null"],"minimum":-100,"maximum":100},"minCycleDays":{"type":["integer","null"],"minimum":0},"maxCycleDays":{"type":["integer","null"],"minimum":0},"minFloor":{"type":["integer","null"],"minimum":-10,"maximum":300},"maxFloor":{"type":["integer","null"],"minimum":-10,"maximum":300},"minFloorTotal":{"type":["integer","null"],"minimum":1,"maximum":300},"maxFloorTotal":{"type":["integer","null"],"minimum":1,"maximum":300},"minConfidence":{"type":["number","null"],"minimum":0,"maximum":1},"sort":{"type":"string","enum":["newest","oldest","price-asc","price-desc","area-asc","area-desc","unit-asc","unit-desc","discount-asc","discount-desc","cycle-asc","cycle-desc"],"default":"newest"},"page":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":1,"maximum":100,"default":24}}}}}},"responses":{"200":{"description":"分页成交记录"},"422":{"description":"查询条件无效"}}}}}}