查询认证主流程明细
接口描述
- 支持查询实名认证流程业务概要信息
接口地址
/v2/identity/auth/api/common/{flowId}/outline
请求方式
- GET
- 请求报文体采用Json数据格式，编码方式采用UTF-8编码
请求参数
| 参数名 | 说明 | 参数类型 | 是否必填 | 类型 |
|---|---|---|---|---|
| flowId | 认证流程id | path | 是 | string |
请求示例
GET /v2/identity/auth/api/common/{flowId}/outline HTTP/1.1
响应参数
| 参数名 | 说明 | 类型 |
|---|---|---|
| code | int | 接口响应结果码 |
| message | string | 接口响应结果描述 |
| data | object | 接口响应结果数据 |
| flowId | string | 认证流程Id |
| flowStatus | string | 流程状态 ，详见：主流程状态对照表 |
| objectType | string | 认证流程主体: ORGANIZATION（组织机构）； INDIVIDUAL（个人）； |
| contextId | string | 认证业务流程发起时的上下文id |
| failReason | string | 认证状态为失败时,失败的原因描述 |
| createTime | long | 流程创建时间时间戳值 |
| modifyTime | long | 流程最后一次状态更新时间时间戳值 |
| subFlows | Array | 认证流程关联的子认证流程的集合 |
| subFlowId | String | 认证流程关联的子认证流程id,可用于查询子认证流程详情 |
| subFlowType | String | 认证流程关联的子认证流程类型,可用于查询子认证流程详情： 1）企业相关认证详情 ORGANIZATION_INFO_AUTH（企业信息比对）； ORGANIZATION_TRANSFER_RANDOM_AMOUNT（企业随机金额打款）；ORGANIZATION_ZMXY（企业芝麻认证）； LEGAL_REP_SIGN_AUTHORIZE（企业法定代表人授权书签署认证）； ORGANIZATION_ARTIFICIAL（企业人工实名）； AUTHCODE（短信验证码校验）； 2）经办人相关认证详情： INDIVIDUAL_ARTIFICIAL（个人人工实名）； INDIVIDUAL_FACEAUTH（个人刷脸认证）； ORGANIZATION_LEGAL_REP_FACEAUTH（企业法定代表人刷脸认证）； NDIVIDUAL_BANKCARD_4_FACTOR（个人银行卡四要素）；INDIVIDUAL_TELECOM_3_FACTOR（个人运营商三要素）； |
| status | String | 认证流程关联的子认证流程状态，详见：子流程状态对照表 |
| relatedFlows | Array | 认证流程关联的附加业务流程的集合,当objectType=ORGANIZATION（组织机构认证）,可能附加个人认证流程,经办人个人身份认证 |
| flowId | string | 经办人认证流程Id |
| flowStatus | string | 经办人认证流程状态，状态值详见：主流程状态对照表 |
| objectType | string | 认证流程主体: ORGANIZATION （组织机构；） INDIVIDUAL（个人）； |
| contextId | string | 认证业务流程发起时的上下文id |
| failReason | string | 认证状态为失败时,失败的原因描述 |
| subFlows | Array | 认证流程关联的子认证流程的集合 |
| subFlowId | String | 认证流程关联的子认证流程id,可用于查询子认证流程详情 |
| subFlowType | String | 认证流程关联的子认证流程类型,可用于查询子认证流程详情. INDIVIDUAL_BANKCARD_4_FACTOR-个人银行卡四要素; INDIVIDUAL_TELECOM_3_FACTOR-个人运营商三要素; INDIVIDUAL_ARTIFICIAL-个人人工实名; AUTHCODE-短信验证码校验; INDIVIDUAL_FACEAUTH-个人刷脸认证; |
| status | String | 认证流程关联的子认证流程状态，状态值详见：子流程状态对照表 |
响应示例
{
"code": 0,
"message": "成功",
"data": {
"flowId": "803719636976683872",
"flowStatus": "ING",
"objectType": "ORGANIZATION",
"failReason": null,
"createTime":1562656814273,
"modifyTime":1562656874000,
"contextId": "8ccce54b-4d40-4dcc-a7ac-464e41f2b468",
"subFlows": [
{
"subFlowId": "5ffbafb2-c3be-45ba-bfeb-fda1f8eb083d",
"subFlowType": "ORGANIZATION_TRANSFER_RANDOM_AMOUNT",
"status": "ING"
},
{
"subFlowId": "3bb55061-f98f-4c89-b236-96b3e7048839",
"subFlowType": "ORGANIZATION_INFO_AUTH",
"status": "ING"
}
],
"relatedFlows": [{
"flowId": "802965095964494307",
"flowStatus": "SUCCESS",
"objectType": "INDIVIDUAL",
"failReason": null,
"contextId": "8ccce54b-4d40-4dcc-a7ac-464e41f2b468",
"subFlows": [
{
"subFlowId": "84322b8a-5baf-4835-82a7-07dbd74c3365",
"subFlowType": "INDIVIDUAL_BANKCARD_4_FACTOR",
"status": "SUCCESS"
}
}]
],
}]
}
}
错误码
| 错误码 | 错误信息 | 错误原因 |
|---|---|---|
| 30500001 | 认证流程不存在 | 要查询的flowId错误 |