guke
a563c1ca4b
docs/api目录文档分类和补全 --------- Co-authored-by: guke <guke@autohome.com.cn> Reviewed-on: #111
23 lines
1009 B
Markdown
23 lines
1009 B
Markdown
# POST /api/v1/auth/jverify-login — 极光一键登录
|
||
|
||
> 所属:Auth 组（前缀 `/api/v1/auth`） | 鉴权:无 | [← 返回 API 索引](../README.md)
|
||
>
|
||
> 集成实现:见 [integrations/jiguang](../integrations/jiguang.md)（极光核验链路、RSA 解密策略、私钥配对踩坑）。
|
||
|
||
## 入参
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
|---|---|---|---|
|
||
| `login_token` | string | ✅（非空） | 客户端极光 `loginAuth` 拿到的 loginToken |
|
||
| `operator` | string | ❌（默认 `""`） | 运营商标识 CM/CU/CT,仅用于后端日志 |
|
||
|
||
## 出参
|
||
响应 `200`:`TokenWithUser`（`user.register_channel` 为 `"jverify"`）。结构见 [API 索引](./README.md#复用数据结构)。
|
||
|
||
## 错误码
|
||
- `502` 极光验证或 RSA 解密失败
|
||
- `403` 账号被禁用
|
||
|
||
## 说明
|
||
后端验真 `login_token` 取回并解密手机号 → 注册即登录（手机号不存在则建号）→ 签发 JWT。极光核验 + RSA 解密的实现细节见 [integrations/jiguang](../integrations/jiguang.md)。
|