通过图片 URL 绑定人脸

POST

/api/v2/mfa/face/associate

请求参数

Header 参数

x-authing-userpool-id

string

用户池 ID

必需

示例值:

59f86b4832eb28071bdd9214

Authorization

string

用户 Token

必需

示例值:

Bearer token

Body 参数application/json

photoA

string

人脸图片 url

必需

photoB

string

人脸图片 url

必需

isExternalPhoto

boolean

图片是否是外链

可选

示例

{
    "photoA": "http://dummyimage.com/400x400",
    "photoB": "http://dummyimage.com/400x400",
    "isExternalPhoto": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://core.authing.cn/api/v2/mfa/face/associate' \
--header 'x-authing-userpool-id: 59f86b4832eb28071bdd9214' \
--header 'Authorization: Bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "photoA": "http://dummyimage.com/400x400",
    "photoB": "http://dummyimage.com/400x400",
    "isExternalPhoto": true
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

thirdPartyIdentity

object

必需

string

必需

createdAt

string

必需

updatedAt

string

必需

userPoolId

string

必需

isRoot

boolean

必需

status

string

必需

oauth

null

必需

string

必需

phone

null

必需

username

string

必需

unionid

null

必需

openid

null

必需

nickname

null

必需

company

null

必需

photo

string

必需

browser

null

必需

device

null

必需

password

string

必需

salt

string

必需

loginsCount

integer

必需

lastIp

string

必需

name

string

必需

givenName

null

必需

familyName

null

必需

middleName

null

必需

profile

null

必需

preferredUsername

null

必需

website

null

必需

gender

string

必需

birthdate

null

必需

zoneinfo

null

必需

locale

null

必需

address

null

必需

formatted

null

必需

streetAddress

null

必需

locality

null

必需

region

null

必需

postalCode

null

必需

city

null

必需

province

null

必需

country

null

必需

registerSource

array[string]

必需

secretInfo

null

必需

emailVerified

boolean

必需

phoneVerified

boolean

必需

lastLogin

string

必需

blocked

boolean

必需

isDeleted

boolean

必需

sendSmsCount

integer

必需

sendSmsLimitCount

integer

必需

encryptedPassword

string

必需

signedUp

string

必需

externalId

null

必需

mainDepartmentId

string

必需

mainDepartmentCode

null

必需

lastMfaTime

string

必需

passwordSecurityLevel

integer

必需

resetPasswordOnFirstLogin

boolean

必需

syncExtInfo

null

必需

phoneCountryCode

null

必需

secondaryUserIds

null

必需

lastIP

string

必需

token

string

必需

tokenExpiredAt

string

必需

customData

object

必需

示例

{
    "code": 200,
    "message": "人脸校验通过",
    "data": {
        "thirdPartyIdentity": {
            "provider": null,
            "refreshToken": null,
            "accessToken": null,
            "scope": null,
            "expiresIn": null,
            "updatedAt": null
        },
        "id": "5a597f35085a2000144a10ed",
        "createdAt": "2021-09-08T02:30:36.194Z",
        "updatedAt": "2022-01-18T04:47:22.079Z",
        "userPoolId": "59f86b4832eb28071bdd9214",
        "isRoot": true,
        "status": "Activated",
        "oauth": null,
        "email": "root@authing.cn",
        "phone": null,
        "username": "root",
        "unionid": null,
        "openid": null,
        "nickname": null,
        "company": null,
        "photo": "https://files.authing.co/authing-console/default-user-avatar.png",
        "browser": null,
        "device": null,
        "password": "423f44e5bccef5f18f87c9be05433b56",
        "salt": "eZHMHdBGOESdsOI8jCDcCGVZMA8qay",
        "loginsCount": 22,
        "lastIp": "::1",
        "name": "xiaoliu",
        "givenName": null,
        "familyName": null,
        "middleName": null,
        "profile": null,
        "preferredUsername": null,
        "website": null,
        "gender": "U",
        "birthdate": null,
        "zoneinfo": null,
        "locale": null,
        "address": null,
        "formatted": null,
        "streetAddress": null,
        "locality": null,
        "region": null,
        "postalCode": null,
        "city": null,
        "province": null,
        "country": null,
        "registerSource": [
            "offcial:import"
        ],
        "secretInfo": null,
        "emailVerified": false,
        "phoneVerified": false,
        "lastLogin": "2022-01-18T04:47:22.064Z",
        "blocked": false,
        "isDeleted": false,
        "sendSmsCount": 0,
        "sendSmsLimitCount": 1000,
        "encryptedPassword": "lpnEUNoSCEcNcnxvvZ5iqY+Y2CPa0NH2vseGSpy/n6Pu71nmQshm09kPdqAzvreYwpMo9f/Hwd3WdhcbCJb/N2C7ekWtnvhByvaxb0Aze8NSpQgtuAWvTVIFLy2aWual0JjY+SbnjNooCWFfuj34yXstX1aEjZ8XHjhADyZEs4o=",
        "signedUp": "2021-09-08T02:30:36.194Z",
        "externalId": null,
        "mainDepartmentId": "613ef1902ee49ba1303159f6",
        "mainDepartmentCode": null,
        "lastMfaTime": "2022-01-17T11:43:19.517Z",
        "passwordSecurityLevel": 1,
        "resetPasswordOnFirstLogin": false,
        "syncExtInfo": null,
        "phoneCountryCode": null,
        "secondaryUserIds": null,
        "lastIP": "::1",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1cGRhdGVkX2F0IjoiMjAyMi0wMS0xOFQwMzoxNzoyOC45NjRaIiwiYWRkcmVzcyI6eyJjb3VudHJ5IjpudWxsLCJwb3N0YWxfY29kZSI6bnVsbCwicmVnaW9uIjpudWxsLCJmb3JtYXR0ZWQiOm51bGx9LCJwaG9uZV9udW1iZXJfdmVyaWZpZWQiOmZhbHNlLCJwaG9uZV9udW1iZXIiOm51bGwsImxvY2FsZSI6bnVsbCwiem9uZWluZm8iOm51bGwsImJpcnRoZGF0ZSI6bnVsbCwiZ2VuZGVyIjoiVSIsImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwiZW1haWwiOiJyb290QGF1dGhpbmcuY24iLCJ3ZWJzaXRlIjpudWxsLCJwaWN0dXJlIjoiaHR0cHM6Ly9maWxlcy5hdXRoaW5nLmNvL2F1dGhpbmctY29uc29sZS9kZWZhdWx0LXVzZXItYXZhdGFyLnBuZyIsInByb2ZpbGUiOm51bGwsInByZWZlcnJlZF91c2VybmFtZSI6bnVsbCwibmlja25hbWUiOm51bGwsIm1pZGRsZV9uYW1lIjpudWxsLCJmYW1pbHlfbmFtZSI6bnVsbCwiZ2l2ZW5fbmFtZSI6bnVsbCwibmFtZSI6InhpYW9saXUiLCJzdWIiOiI1YTU5N2YzNTA4NWEyMDAwMTQ0YTEwZWQiLCJleHRlcm5hbF9pZCI6bnVsbCwidW5pb25pZCI6bnVsbCwidXNlcm5hbWUiOiJyb290IiwiZGF0YSI6eyJ0eXBlIjoidXNlciIsInVzZXJQb29sSWQiOiI1OWY4NmI0ODMyZWIyODA3MWJkZDkyMTQiLCJhcHBJZCI6IjYxMzgyMDRjMTk0ZjI3NTk5YTE2M2RhNyIsImlkIjoiNWE1OTdmMzUwODVhMjAwMDE0NGExMGVkIiwidXNlcklkIjoiNWE1OTdmMzUwODVhMjAwMDE0NGExMGVkIiwiX2lkIjoiNWE1OTdmMzUwODVhMjAwMDE0NGExMGVkIiwicGhvbmUiOm51bGwsImVtYWlsIjoicm9vdEBhdXRoaW5nLmNuIiwidXNlcm5hbWUiOiJyb290IiwidW5pb25pZCI6bnVsbCwib3BlbmlkIjpudWxsLCJjbGllbnRJZCI6IjU5Zjg2YjQ4MzJlYjI4MDcxYmRkOTIxNCJ9LCJ1c2VycG9vbF9pZCI6IjU5Zjg2YjQ4MzJlYjI4MDcxYmRkOTIxNCIsImF1ZCI6IjYxMzgyMDRjMTk0ZjI3NTk5YTE2M2RhNyIsImV4cCI6MTY0MzY5MDg0MiwiaWF0IjoxNjQyNDgxMjQyLCJpc3MiOiJodHRwOi8vY29uc29sZS5hdXRoaW5nLmxvY2FsaG9zdDozMDAwL29pZGMifQ.c1fJQQZnWf8VlzVg1JecAc5mKaFjEVw9fiRUS49EYnU",
        "tokenExpiredAt": "2022-02-01T04:47:22.057Z",
        "customData": {
            "cip": "erre"
        }
    }
}

修改于 2022-01-18 07:32:46

检测手机号或邮箱是否已被绑定

人脸二次认证