智位小猿开放平台 API

Base URL: https://energy.aixgn.cn/api/weixiaoyuan · 认证: Bearer Token · 版本: v1.0

认证

POST登录

/auth/login

用户登录，返回token和用户信息

参数	类型	必填	说明
phone	string	是	手机号
role	string	是	admin/agent/property/owner/customer
name	string	否	姓名

{"phone":"13800138000","role":"customer"}

{"token":"eyJ...","user":{"id":"u1","name":"陈先生","role":"customer"}}

房源

GET房源列表

/broker/listings?type=sale&status=pending

分页查询房源，支持按类型和状态筛选

{"data":[{"id":"l1","title":"保利香槟A区0123","price":360000}],"total":12}

POST审核房源

/broker/listings/{id}/review

物业审核房源通过或驳回

{"approved":true,"reason":""}

交易

POST交易状态变更

/broker/transactions/{id}/status

approve/sign/complete/reject

{"action":"approve"}

带看

GET带看列表

/broker/viewings?agentId=a1

查询中介的带看记录

IoT

POST地锁控制

/iot/lock/control

升起或降下地锁

{"spotId":"s1","action":"up"}

支付

POST创建支付

/payments/create

创建支付单，返回支付单号

{"amount":360000,"method":"wechat"}

合同

GET获取合同

/contracts/{transactionId}

返回合同HTML

通知

GET通知列表

/notifications?role=customer

查询当前用户通知

BI/数据

GET成交趋势

/bi/sales-trend?days=30

返回按日的成交金额和笔数

RBAC/审计

GET审计日志

/audit/logs?module=交易&page=1

分页查询操作日志

📖 API文档 v1.0