Skip to content

邮箱+邮件验证码二次认证接口

登录过程中如果需要邮箱+邮件验证码二次认证,则调用本接口进行二次认证。

请求说明

请求头

参数名中文名称必须类型描述
X-operating-sys-version调用方操作系统版本Stringwindows10.1.1
X-device-fingerprint调用方设备指纹String156aysdna213sc50
X-device-ip调用方IPString192.168.1.2
X-agentUser-Agent信息StringMozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15(KHTML, like Gecko) Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace
X-L用于国际化语言设置Stringzh
X-client-id应用授权IDStringnTo1eRIub60vPb54WeE6aojPwYwImtl4
X-state-token临时令牌StringeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWJqZW1...

请求示例

json
{
    "email": "zhangsan@qq.com",
    "verify_code": "123456"
}

请求参数

参数名中文名称必须类型描述
email邮箱String接收验证码的邮箱
verify_code邮件验证码String接收到的验证码
获取验证码请参考发送邮件验证码接口
type = MFA_AUTH_EMS

返回示例

成功示例

HTTP/1.1 200 OK

json
{
    "status": "SUCCESS",
    "expire": 43200,
    "session_token": "LGTiTNVDFPlpefV3F3Hla7RUFTqInsqa",
    "id_token": "eyJraWQiOiJrMSIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJJc3N1ZXIiLCJhdWQiOiJBdWRpZW5jZSIsImV4cCI6MTY1MzQ4NDQxMiwianRpIjoieUxSVGZXY1VkYk9PeUFpbHdZU0ZqZyIsImlhdCI6MTY1MzQ2NjQxMiwibmJmIjoxNjUzNDY2MjkyLCJzdWIiOiJzdWJqZWN0IiwiYXBpIjoie1wibmFtZVwiOlwiXCIsXCJtb2JpbGVcIjpcIis4Ni0xNTkwNzEzMjg1MlwiLFwiaWRcIjpcIjIwMjIwNDI1MTQwMTM4NTE5LUJGMUItNTI4QjA1NTFCXCIsXCJ1c2VyTmFtZVwiOlwibG91eGlcIixcImVtYWlsXCI6XCIxMUBxcS5jb21cIn0ifQ.al79knH1fKa4aT4AFr_FMjqBKu2pV_g-lKzzgHzmor5X-dHwSBUtjH38KOzjIqHvkcRMjXQuBnWmjRI7-0Djn2LuWVueaf3wRXLscCWiSDC7chjUyTRXMatYINxdvW-oSWFYGFqqbdsavLqOnvehd7ahEaTuiL9yZolvslZIkIxjxBJJu7A9Ln2sk3wf9pxXU83jIJ8ubPQBoVS-ilerTTJOKDZ9XsL2ftJsaqdTJK_mYbvKaVpLIVyHHJ2NcF6f-Al4N4kc8cgxtSgSKFDcR7Bz7dYlOcfUXCPAzJ3NZInm8UaksiWU02tvlvTRvRdoxZNnvD5vamZ5hjFc-cW5jA"
}
}

错误示例

HTTP/1.1 400 Bad Request

json
{
    "error_code": "SDK.COMMON.1001",
    "error_msg": "Parameter X-client-id cannot be left blank."
}

返回参数

参数名中文名称类型描述
status返回结果String该字段可能返回的值如下
SUCCESS 登录成功
ACCESS_DENIED 拒绝访问
expiresession_token有效期Numbersession_token有效期,有效期内可使用session_token获取ticket
session_token用户session_tokenString用户session_token,可使用该token调用IDaaS接口获取sso_ticket,sso_ticket可以换取用户信息

竹云IDaaS开放平台