开发者文档
官网控制台

提交 RFI 答案

POST
/openapi/v1/customers/provider-kyc/rfis/{rfiId}/answers

一次提交待作答 RFI 全部题目的答案。

请求为 multipart/form-data：data 部分是 JSON 答案，其余每个部分是一个文件，部分名等于 answers[].clientFileIds 中的值。

  • RFI 已在审核中（UNDER_REVIEW）时，返回当前状态，不写入，不带 submittedAt。
  • Idempotency-Key 必填。重试同一次提交时复用原键，渠道不会受理两次。
  • 受理不等于审核通过，也不解除 restrictions。
  • 本地只校验必需字段非空、clientFileId 安全字符、文件对应关系、文件大小和类型。题目归属、必答、长度、文件数、勾选值由渠道判定，不符合时返回 openapi.channel.rejected。

各题型的答案写法见 渠道 KYC 与开户。

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。

路径参数

rfiId*string

渠道分配的 RFI ID。

Header 参数

X-Channel-Provider*string

渠道提供商标识。渠道侧 KYC 当前只支持 LEGEND。

Idempotency-Key*string

唯一请求标识，最长 128 字符。重试同一次提交时复用原键。缺失返回 error.idempotent.key.missing。

请求体

multipart/form-data
  1. body

data 部分加文件部分。每个文件部分的部分名等于一个 answers[].clientFileIds 中的值。

data*

整张 RFI 的答案，作为 multipart 的 data 部分。未知字段会被拒绝。

[key: string]?unknown

文件内容。单个文件不超过 2 MB，类型限 PDF、PNG、JPEG。

响应体

返回提交结果。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?
请求示例
curl -X POST 'https://api.test.stabofx.com/openapi/v1/customers/provider-kyc/rfis/rfc_xxx/answers' \  -H 'X-Channel-Provider: LEGEND' \  -H 'Idempotency-Key: 5f0c7b2e-1d3a-4c8e-9b6f-2a4d6e8f0a1c' \  -F 'data={  "customerUid": "cust_example_001",  "answers": [    {      "questionId": "rfq_text"    }  ]}' \  -F 'property1=null' \  -F 'property2=null'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "trace-uuid-string",  "data": {    "rfiId": "rfc_xxx",    "status": "UNDER_REVIEW",    "submittedAt": "2026-11-10T10:00:00+08:00"  }}