功能说明​

使用邮箱和验证码登录，验证码通过后可自动创建尚不存在的用户。

请求说明​

请求鉴权：免登录，仅需 appkey，无需 Authorization。

请求类型：POST

请求限频：100次/秒

请求地址：https://请求域名/jim/email/login

Content-Type：application/json

请求参数​

设备字段放在 JSON 顶层。先使用 SDK getDeviceId 获取实际连接标识。兼容期仅两个身份键同时不传允许旧登录；只传一项、空值、null 或类型错误拒绝，严格截止后旧登录返回 17605。详见 设备登录规则。

先调用 发送邮箱验证码 获取实际验证码。普通记录按创建时间校验五分钟有效期；当前校验服务有测试放行分支，不属于客户端协议，不能据此承诺严格验证码防绕过。

请求示例​

POST /jim/email/login HTTP/1.1
appkey: appkey
Content-Type: application/json

{
  "email":"demo@example.com",
  "code":"<实际下发的验证码>",
  "device_id":"sdk-device-demo",
  "platform":"web"
}

响应示例​

{
  "code":0,
  "msg":"success",
  "data":{
    "user_id":"userid1",
    "authorization":"xxxxxxxxx",
    "nickname":"user1",
    "avatar":"xxxxxxxx",
    "status":0,
    "im_token":"xxxxxxxxx"
  }
}

成功字段类型、凭证用途和同设备重新登录替换会话见 登录响应。验证码校验失败通常 17009；JSON/邮箱不合法 17003，IM 注册失败 17004，设备参数及封禁错误见 错误码。处理网络失败、非 2xx 和业务 code，不只检查 HTTP 200。