厦门落户资格诊断 · 能力接口

把「厦门落户能不能办、还差什么」这件事，做成一个 AI Agent 可以自己发现、自己付费、自己调用的一次性能力。

如果你是人，直接点这里做免费自测就行，不用看这个页面。

两个接口

方法	路径	收费	说明
GET	/api/xm/luohu/meta	免费	能力自描述：入参字段、可选值、返回结构、定价。Agent 用它决定要不要买。
POST	/api/xm/luohu	¥5.90 / 次	生成完整诊断报告。未付款时返回 402 与账单，付款后带凭证重试。
GET	/health	免费	健康检查，含当前计费模式（mock / alipay）。

同一个诊断能力也以 Skill 包形式在 SkillPay 上架，供支持 Skill 的智能体按月订阅调用；两条通道计价独立。

按量付费怎么走（HTTP 402）

第一次请求 → 402 Payment Needed响应头 Payment-Needed 是 Base64URL 编码的账单 JSON；响应体里同时给出 out_trade_no、resource_id、amount、pay_before。
Agent 用支付宝 AI 付完成这笔账单这是去中心化支付，没有收银台页面，也不需要人来点。
带着支付凭证重试同一个请求请求头加 Payment-Proof（支付凭证）和 X-Out-Trade-No（第 1 步拿到的订单号）。
200 + 报告服务端验签通过后生成报告并返回；同一笔交易重复调用只会拿到同一份报告，不会重复扣费。

请求示例

# 1) 先问能力（免费）
curl -s https://119-28-203-250.sslip.io/api/xm/luohu/meta

# 2) 直接调用付费接口，会拿到 402 与账单
curl -si -X POST https://119-28-203-250.sslip.io/api/xm/luohu \
  -H 'Content-Type: application/json' \
  -d '{"age":31,"education":"本科","district":"集美","social_months":8,
       "residence_months":9,"has_lease_record":false,"is_fresh_graduate":false}'
# → HTTP/1.1 402 Payment Needed
# → Payment-Needed: eyJwcm90b2NvbCI6eyJhbW91bnQiOiI1LjkwIi...

# 3) 付款后带凭证重试，拿到报告
curl -s -X POST https://119-28-203-250.sslip.io/api/xm/luohu \
  -H 'Content-Type: application/json' \
  -H 'Payment-Proof: <支付凭证>' \
  -H 'X-Out-Trade-No: <第 2 步的 out_trade_no>' \
  -d '{...同一份入参...}'

入参与返回

字段	类型	取值
age	int	0–120 周岁
education	string	博士 / 硕士 / 本科 / 大专 / 中专及以下
district	string	思明 / 湖里（岛内）；集美 / 海沧 / 同安 / 翔安（岛外）
social_months	int	在厦连续缴纳社保月数
residence_months	int	在厦连续居住登记月数
has_lease_record	bool	是否有住房租赁备案
is_fresh_graduate	bool	是否走毕业生通道
graduate_fulltime	bool	是否全日制学历

返回：verdict_level / verdict（结论）、best_path（推荐路径与匹配度、还差的条件、预计等待月数）、all_paths（四条路径逐条对照）、next_actions（按顺序要做的事）、documents（材料清单）、timeline（时间线）、warnings（常见坑）、contacts（官方咨询电话）。

政策依据：厦府规〔2025〕13 号，2025 年 11 月 1 日起施行，有效期 5 年。

给 Agent 的接入约定

约定	值
幂等	同一 Payment-Proof 重复调用返回同一份报告，不重复计费
有效期	账单在 pay_before 之前有效；逾期需重新发起请求换新账单
失败响应	凭证验签不通过一律返回 402（不区分「过期」与「伪造」），请重新发起请求
入参校验	字段非法时返回 400 并给出可选值，不做静默纠错

先看能力描述（免费）我是人，去做免费自测