跳转到正文
登录验证

提交短信验证码

submit_sms:登录要求短信验证时提交收到的验证码。

const LoginResult *submit_sms(uint64_t self_id, const char *platform,
                              const char *attempt_id, const char *code);
void free_login_result(const LoginResult *result);
  • 权限:submit_sms
  • 调用要求:会等待服务器回应,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是同一次登录尝试的 self_id
platformconst char *是同一次登录尝试的 platform
attempt_idconst char *是同一次登录尝试的 attempt_id
codeconst char *是收到的短信验证码

返回值 LoginResult

用完必须调用 free_login_result(result) 交还;客户端未提供接口时返回 NULL。

字段类型说明
codeint32_t登录服务返回码;本地失败时为 RESULT_LOCAL_ERROR(-1)
attempt_idconst char *本次登录会话号,续登接口(submit_captcha / send_sms / submit_sms)必须原样传回
urlconst char *滑块或设备验证地址,无内容时为 ""
country_codeconst char *短信验证手机区号,可能为空
mobileconst char *短信验证打码手机号,可能为空
resend_afteruint32_t短信验证多少秒后可重发
msgconst char *服务端原始提示/错误文案,本地失败时为本地原因

结果判定规则

  • 仅当 code == 0 且 attempt_id 为空字符串时,才表示已上线;不能仅凭 code == 0 判断登录完成。
  • code == 2 且 attempt_id 非空:打开 url 完成滑块,将取得的 ticket 交给 submit_captcha。
  • code == 160 或 239、attempt_id 非空且 url 为空:可调用 send_sms 下发短信,再调用 submit_sms 提交验证码(country_code/mobile 可能为空,不能仅凭有没有手机号判断是否需要短信)。
  • send_sms 返回 code == 0 且 attempt_id 非空:仅表示短信下发成功,仍须用同次 self_id/platform/attempt_id 调用 submit_sms。
  • 设备或身份验证提供 url 时,不能将其验证码结果混用于登录滑块;submit_captcha/send_sms/submit_sms 不是通用设备验证完成接口。
  • 每次续登后均须重新检查 LoginResult;如需取消登录,调用 offline_account。

本页目录