/rfi-status

当用户的 RFI 状态发生变更时（发起、用户提交、被拒、通过、关闭），都会调用这个 API 来通知交易所用户 RFI 状态。此 API 为可选，交易所可以选择是否希望收到用户 RFI 状态。

回调路径可自定义，默认为 /rfi-status。开通此接口不影响 Legend 向用户发送 RFI 邮件。

请求参数说明

参数名	类型	必传	说明
`uid`	string	是	用户在交易所侧的唯一标识符
`rfi_unique_id`	string	是	本次 RFI 的唯一编号，建议用作幂等主键
`rfi_status`	string	是	RFI 状态。可选值： `requested`（已发起）`in_review`（审核中）`declined`（已拒绝）`accepted`（已通过）`closed`（已关闭）
`rfi_url`	string	是	RFI 填写页面完整地址，可直接提供给用户补充材料
`created_at`	string	是	RFI 创建时间，UTC，格式 `YYYY-MM-DDTHH:mm:ssZ`
`updated_at`	string	是	RFI 最近更新时间，格式同上

推送数据示例

{
  "uid": "417ubQ==",
  "rfi_unique_id": "a1b2c3d4e5f6",
  "rfi_status": "in_review",
  "rfi_url": "https://rfi.legendtrading.com/a1b2c3d4e5f6",
  "created_at": "2026-08-20T02:11:05Z",
  "updated_at": "2026-08-26T03:40:22Z"
}

接口要求

请求成功以 HTTP 状态码 200 判定，响应内容不参与判定，建议返回 {"code":0,"message":"ok"}。
Legend 会在通知失败（网络异常或非 200 响应）时通过队列重试，最多尝试 3 次，重试间隔 60 秒。仍失败时会记录错误日志；如需补推历史事件，请联系 Legend 技术支持。
同一 RFI 可能因状态流转或队列重试收到重复通知，请按 rfi_unique_id + rfi_status 做幂等处理。
异步通知可能乱序到达，请按 updated_at 判断是否为最新状态，避免旧状态覆盖新状态。