¶ 获取用户实名认证信息

更新时间: 2024-10-10 07:28:40

通过用户 ID，获取用户实名认证信息，可以选择指定用户 ID 类型。

¶ 请求参数

名称	类型	必填	默认值	描述	示例值
userId	string	是	-	用户 ID。	`6229ffaxxxxxxxxcade3e3d9`
userIdType	string	否	user_id	用户 ID 类型，可以指定为用户 ID、手机号、邮箱、用户名和 externalId。。枚举值：`user_id`,`external_id`,`phone`,`email`,`username`	`user_id`

¶ 示例代码

package main

import (
    "github.com/Authing/authing-golang-sdk/management"
    "github.com/Authing/authing-golang-sdk/dto"

    "fmt"
)

func main() {
    options := management.ClientOptions {
        AccessKeyId:     "AUTHING_USERPOOL_ID",
        AccessKeySecret: "AUTHING_USERPOOL_SECRET",
    }

    client, err := management.NewClient(&options)
    if err != nil {
        // The exception needs to be handled by the developer.
    }

    response := client.getUserPrincipalAuthenticationInfo(
    
     
        userId: "6229ffaxxxxxxxxcade3e3d9"        , 
        userIdType: "user_id"        
  )
}

¶ 请求响应

类型： PrincipalAuthenticationInfoPaginatedRespDto

名称	类型	描述
statusCode	number	业务状态码，可以通过此状态码判断操作是否成功，200 表示成功。
message	string	描述信息
apiCode	number	细分错误码，可通过此错误码得到具体的错误类型。
data	PrincipalAuthenticationInfoPagingDto	响应数据

示例结果：

{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "list": {
      "authenticated": true,
      "principalType": "认证主体类型，P 代表个人，E 代表企业",
      "principalCode": "6229c4deb3e4d8a20b6021ff",
      "principalName": "ss",
      "authenticatedAt": "2022-04-05T10:23:50.631Z"
    }
  }
}

¶ 数据结构

¶ PrincipalAuthenticationInfoPagingDto

名称	类型	必填	描述
totalCount	number	是	记录总数。
list	array	是	响应数据。嵌套类型：PrincipalAuthenticationInfoDto。

¶ PrincipalAuthenticationInfoDto

名称	类型	必填	描述
authenticated	boolean	是	是否进行认证。示例值： `true`
principalType	string	是	用户 ID。示例值： `认证主体类型，P 代表个人，E 代表企业`
principalCode	string	是	认证主体证件号码。示例值： `6229c4deb3e4d8a20b6021ff`
principalName	string	是	认证主体名称。示例值： `ss`
authenticatedAt	string	是	认证时间，标准时间字符串。示例值： `2022-04-05T10:23:50.631Z`

上一篇: 获取用户角色列表下一篇: 删除用户实名认证信息