文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 验证码相关/ 校验验证码 - ValidateCode
更新时间：2026-05-15 GMT+08:00
查看PDF
分享

校验验证码 - ValidateCode

功能介绍

校验验证码

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/verify/code/validate

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Traceid

否

String

参数解释：

业务跟踪id（必须58位）

约束限制：

不涉及

取值范围：

长度为58位

默认值：

不涉及

x-hw-agentName

是

String

参数解释：

agentName

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及
表2 请求Body参数

参数

是否必选

参数类型

描述

requestId

是

String

请求Id

code

是

String

验证码

codeType

是

String

验证码类型 1-注册，2-登录，3-重置密码，4-修改手机号

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

String

错误码

msg

String

错误描述

data

data object

验证码校验响应
表4 data

参数

参数类型

描述

verified

Boolean

是否验证成功

token

String

验证通过后的令牌

expireAt

String

过期时间

failCount

String

检查时间内的失败次数，失败时必填

请求示例

POST /koodrive/ose/v1/verify/code/validate

{
  "requestId" : "1893584627570952064",
  "code" : "4719",
  "codeType" : "1"
}

响应示例

状态码：200

验证码校验响应

{
  "data" : {
    "verified" : true,
    "token" : "8VKh3YgjNs+VJqbCqo/ouhqBJaLaK/5WLEQXOzdCU3o=",
    "expireAt" : "2026-02-25T08:26:31.514"
  },
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

验证码校验响应
父主题： 验证码相关