获取个人认证&授权链接

POST

/api/psnAuthUrl

用于获取个人的认证授权页面链接，通过此链接个人用户可进行个人实名认证、资源授权等操作。

注意

用户授权有效期默认永久有效（100年）。

可以调用【获取个人授权信息】获取个人授权有效期和授权范围

可以调用【查询个人认证信息】查询个人的认证状态和个人openPsnId

个人认证方式2种（暂时不可控制认证方式）

个人信息+个人人脸OCR

个人信息+运营商三要素

设置页面中可选择的个人授权范围

get_psn_ident_info - 授权允许获取个人身份信息

get_psn_signature_info - 授权允许获取个人用户的签名资源

psn_sign_task_init - 授权允许代表个人发起合同

get_psn_sign_task_info - 授权允许获取个人用户的合同信息

get_psn_sign_task_file - 授权允许获取个人用户的合同文件

get_psn_template - 授权允许获取个人用户的模版

请求头格式

具体请求头参数，请查看公共请求格式

请求参数

Body 参数application/json

示例

{
    "psnAuthConfig": {
        "psnAccount": "19843425674",
        "openPsnId": null,
        "psnName": "吴娜",
        "psnIDCardType": "CRED_PSN_CH_IDCARD",
        "psnIDCardNum": "31757818410214807X",
        "psnInfo": {
            "psnName": null
        }
    },
    "authorizeConfig": {
        "authorizedScopes": [
            "get_psn_ident_info"
        ]
    },
    "redirectConfig": null,
    "clientType": "h5"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://api.pre-qiandun365.com/api/psnAuthUrl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "psnAuthConfig": {
        "psnAccount": "19843425674",
        "openPsnId": null,
        "psnName": "吴娜",
        "psnIDCardType": "CRED_PSN_CH_IDCARD",
        "psnIDCardNum": "31757818410214807X",
        "psnInfo": {
            "psnName": null
        }
    },
    "authorizeConfig": {
        "authorizedScopes": [
            "get_psn_ident_info"
        ]
    },
    "redirectConfig": null,
    "clientType": "h5"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "result": {
        "authUrl": "https://saas-h5.pre-qiandun365.com/#/openPlatform/authorize/index?code=e4ylpyg8p98xzam6rr8f&appId=90",
        "authFlowId": "100003435",
        "authCode": "e4ylpyg8p98xzam6rr8f"
    },
    "code": "200",
    "msg": "成功",
    "logKey": "dafb3079",
    "ts": "1711420288018",
    "success": true
}

修改于 2025-02-06 01:35:37

用户认证&授权流程

查询个人认证信息

获取个人认证&授权链接

个人认证方式2种（暂时不可控制认证方式）#

设置页面中可选择的个人授权范围#

请求头格式#

请求参数

请求示例代码

返回响应

个人认证方式2种（暂时不可控制认证方式）

设置页面中可选择的个人授权范围

请求头格式