Current contract

ORION Sunshine API

本页只记录目前代码实际提供的端点与可信度边界,不使用虚构响应、虚构笔数或假成功范例。

GET/api/public/data

前台地图资料

只返回数据库中已验证、已发布且有效的挂牌与已验证成交;没有资料时 source=empty。

GET/api/listings · /api/transactions

公开唯读查询

提供同一正式资料库的筛选、分页与地理范围查询,不会补入静态案例。

POST/api/estimate

数据库估值

输入 building_id、area_sqm 与可选 floor。只使用过去 12 个月已验证成交;没有足够资料时返回空估值,不降级为示范数字。

POST/api/listings · /api/transactions

旧版写入已停用

返回 HTTP 410。挂牌必须经认证后台流程;成交必须经后台 CSV 验证与原子汇入,所有新成交预设未验证。

认证与写入原则

公开端点不会代表管理员写入。机构资料变更请登入后台,并由角色权限、组织范围、验证规则与稽核记录共同保护。

登入后台