Skip to content

发送验证码

  • 接口地址:/api/v2/common/send-verify-code
  • 请求方式:POST
  • 传参方式:application/json

Headers 可选参数

参数名公开模式(是否必传)私有模式(是否必传)
X-Fresns-AidNONO
X-Fresns-Aid-TokenNONO
X-Fresns-UidNONO
X-Fresns-Uid-TokenNONO

Body 参数

参数名类型是否必传说明
typeStringYES发送类型:email,sms
useTypeNumberYES用途类型:1.新账号验证 / 2.已存账号验证 / 3.填空验证 / 4.身份验证 / 5.其他
templateIdNumberYES模板编号
accountStringNO邮箱或者手机号(用途为 4 时无需必传,其他类型必传)
countryCodeNumberNO手机号码专用,专用时必填,国际区号

接口使用说明

  • useType 用途类型
    • 1 新账号验证: 未登录时也可请求,但是账号必须在数据库中不存在。例如,新注册、更换绑定等。
    • 2 已存账号验证: 未登录时也可请求,但是账号必须在数据库中存在。例如,验证码登录、重置密码等。
    • 3 填空验证: 登录时才可请求,并且账号的对应的邮箱或手机号必须为空。例如,设置账号邮箱或手机号绑定等。
    • 4 身份验证: 登录时才可请求,无需 account 参数,系统将使用当前登录账号的绑定邮箱或手机号发送验证码。例如,修改重要资料的前置验证等。
    • 5 按传参账号直接发送。
  • 接口限制,1 分钟内容仅可发送 1 条验证码,10 分钟内 5 条。接口之外,如果另外限制,则由关联的插件决定。

返回结果

json
{
    "code": 0,
    "message": "ok",
    "data": null
}
开发说明
  • 凭 useType 参数判断当前请求是否有权发送验证码。
  • 有权发送后,调用命令字发送 sendCode

Released under the Apache-2.0 License