{"components":{"schemas":{"PublicAIPropertyFeedItem":{"properties":{"available_actions":{"items":{"type":"string"},"type":"array"},"business_district_name":{"nullable":true,"type":"string"},"canonical_path":{"type":"string"},"district_name":{"nullable":true,"type":"string"},"id":{"type":"string"},"lang":{"enum":["zh"],"type":"string"},"name":{"nullable":true,"type":"string"},"property_ref":{"type":"string"},"publication_version":{"type":"string"},"type":{"enum":["residential_property"],"type":"string"},"verification_status":{"enum":["published"],"type":"string"}},"type":"object"},"PublicAIPropertyFeedResponse":{"properties":{"contract_version":{"enum":["2026-10-27.v1"],"type":"string"},"data":{"items":{"$ref":"#/components/schemas/PublicAIPropertyFeedItem"},"type":"array"},"meta":{"$ref":"#/components/schemas/PublicPublicationMeta"}},"required":["data","meta","contract_version"],"type":"object"},"PublicHouseType":{"description":"Public house-type facts without internal IDs. Unknown is not zero; zero bedrooms is a confirmed studio.","properties":{"area":{"nullable":true,"type":"number"},"bathroom_count":{"nullable":true,"type":"integer"},"bedroom_count":{"nullable":true,"type":"integer"},"livingroom_count":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"},"plan_image_url":{"nullable":true,"type":"string"}},"type":"object"},"PublicProperty":{"properties":{"address":{"nullable":true,"type":"string"},"alias":{"nullable":true,"type":"string"},"architectural_style":{"nullable":true,"type":"string"},"available_listing_count":{"type":"integer"},"avg_building_distance":{"nullable":true,"type":"number"},"building_count":{"nullable":true,"type":"integer"},"business_district_name":{"nullable":true,"type":"string"},"canonical_path":{"type":"string"},"cold_water_fee":{"nullable":true,"type":"number"},"delivery_date":{"nullable":true,"type":"string"},"developer":{"nullable":true,"type":"string"},"district_code":{"nullable":true,"type":"string"},"district_name":{"nullable":true,"type":"string"},"electricity_fee":{"nullable":true,"type":"number"},"floor_area_ratio":{"nullable":true,"type":"number"},"floor_height":{"nullable":true,"type":"number"},"gas_fee":{"nullable":true,"type":"number"},"grade":{"nullable":true,"type":"string"},"greening_rate":{"nullable":true,"type":"number"},"has_clubhouse":{"nullable":true,"type":"string"},"has_elevator":{"nullable":true,"type":"string"},"has_gym":{"nullable":true,"type":"string"},"has_natural_gas":{"nullable":true,"type":"boolean"},"has_pool":{"nullable":true,"type":"string"},"heating_fee":{"nullable":true,"type":"number"},"heating_type":{"nullable":true,"type":"string"},"hot_water_fee":{"nullable":true,"type":"number"},"house_type_count":{"type":"integer"},"house_types":{"items":{"$ref":"#/components/schemas/PublicHouseType"},"type":"array"},"household_count":{"nullable":true,"type":"integer"},"id":{"type":"string"},"land_acquisition_date":{"nullable":true,"type":"string"},"land_area":{"nullable":true,"type":"number"},"max_rent":{"nullable":true,"type":"number"},"min_rent":{"nullable":true,"type":"number"},"missing":{"items":{"type":"string"},"type":"array"},"name":{"nullable":true,"type":"string"},"name_en":{"nullable":true,"type":"string"},"parking_count":{"nullable":true,"type":"integer"},"parking_management_fee":{"nullable":true,"type":"number"},"parking_ratio":{"nullable":true,"type":"string"},"parking_rent":{"nullable":true,"type":"number"},"power_supply":{"nullable":true,"type":"string"},"property_company":{"nullable":true,"type":"string"},"property_fee":{"nullable":true,"type":"number"},"property_ref":{"type":"string"},"property_type":{"nullable":true,"type":"string"},"property_years":{"nullable":true,"type":"string"},"publication_version":{"type":"string"},"published_lang":{"type":"string"},"sort_order":{"type":"integer"},"transport":{"description":"Governed ring-road, metro and hub facts; no relationship IDs, source or confidence.","type":"object"},"verification_status":{"type":"string"},"water_supply":{"nullable":true,"type":"string"}},"required":["id","property_ref","canonical_path","available_listing_count","house_type_count","published_lang"],"type":"object"},"PublicPropertyDetailResponse":{"properties":{"contract_version":{"enum":["2026-10-27.v1"],"type":"string"},"data":{"$ref":"#/components/schemas/PublicProperty"},"meta":{"$ref":"#/components/schemas/PublicPublicationMeta"}},"required":["data","meta","contract_version"],"type":"object"},"PublicPropertyListResponse":{"properties":{"contract_version":{"enum":["2026-10-27.v1"],"type":"string"},"data":{"items":{"$ref":"#/components/schemas/PublicProperty"},"type":"array"},"meta":{"$ref":"#/components/schemas/PublicPublicationMeta"}},"required":["data","meta","contract_version"],"type":"object"},"PublicPublicationMeta":{"properties":{"authority_contract_version":{"type":"string"},"content_lang":{"enum":["zh"],"type":"string"},"generated_at":{"description":"Response generation time, not verification or fact update time.","format":"date-time","type":"string"},"lang":{"enum":["zh"],"type":"string"},"language_fallback":{"type":"boolean"},"publication_version":{"type":"string"},"published_records":{"type":"integer"},"requested_lang":{"enum":["zh","en"],"type":"string"},"visibility":{"type":"string"}},"required":["requested_lang","content_lang","language_fallback","generated_at"],"type":"object"}}},"info":{"description":"Current rentpro_business facts under channel placement restrictions. Original property URLs are preserved; old content never supplies facts.","title":"RentPro Authority-backed Public API","version":"2.0.0"},"openapi":"3.0.3","paths":{"/api/public/agents.json":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Metadata; health is not an authority readiness check."}},"summary":"Public service metadata"}},"/api/public/ai-feed":{"get":{"parameters":[{"description":"Requested language: zh or en. Current content is Chinese; en reports language_fallback=true.","in":"query","name":"lang","required":false,"schema":{"default":"zh","enum":["zh","en"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAIPropertyFeedResponse"}}},"description":"Current public facts; errors never fall back to old content."},"400":{"description":"Invalid query or reference"},"404":{"description":"Currently unavailable property"},"409":{"description":"Publication or listing changed during read"},"429":{"description":"Authority query rate limited"},"503":{"description":"Authority unavailable or channel mapping incomplete"}},"summary":"Current authority-backed public property data"}},"/api/public/health":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Metadata; health is not an authority readiness check."}},"summary":"Public service metadata"}},"/api/public/properties":{"get":{"parameters":[{"description":"Requested language: zh or en. Current content is Chinese; en reports language_fallback=true.","in":"query","name":"lang","required":false,"schema":{"default":"zh","enum":["zh","en"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyListResponse"}}},"description":"Current public facts; errors never fall back to old content."},"400":{"description":"Invalid query or reference"},"404":{"description":"Currently unavailable property"},"409":{"description":"Publication or listing changed during read"},"429":{"description":"Authority query rate limited"},"503":{"description":"Authority unavailable or channel mapping incomplete"}},"summary":"Current authority-backed public property data"}},"/api/public/properties/{id}":{"get":{"parameters":[{"description":"Requested language: zh or en. Current content is Chinese; en reports language_fallback=true.","in":"query","name":"lang","required":false,"schema":{"default":"zh","enum":["zh","en"],"type":"string"}},{"description":"Stable legacy decimal-string ID or a mapped business-property: reference.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyDetailResponse"}}},"description":"Current public facts; errors never fall back to old content."},"400":{"description":"Invalid query or reference"},"404":{"description":"Currently unavailable property"},"409":{"description":"Publication or listing changed during read"},"429":{"description":"Authority query rate limited"},"503":{"description":"Authority unavailable or channel mapping incomplete"}},"summary":"Current authority-backed public property data"}},"/api/public/rentpro-install":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Metadata; health is not an authority readiness check."}},"summary":"Public service metadata"}},"/api/public/schema":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Metadata; health is not an authority readiness check."}},"summary":"Public service metadata"}}},"servers":[{"description":"Channel public API gateway; not the MCP business backend","url":"https://api.smartrent.xin"}],"x-rentpro-authority-contract":"2026-10-27.v1"}