快手用户ID与快手ID有何区别？如何转换？

摘要： 核心概念：两种ID的区别我们必须明确这两个ID指的是什么,因为它们的用途和格式完全不同，快手用户ID (User ID / uid)定义：这是快手在后端系统中使用的、全局唯一的数字...

核心概念：两种ID的区别

我们必须明确这两个ID指的是什么,因为它们的用途和格式完全不同。

快手用户ID (User ID / uid)

• 定义：这是快手在后端系统中使用的、全局唯一的数字ID，它是一个长整型数字（1234567890）。
• 特点：
  • 唯一性：每个用户从注册开始，这个ID就固定不变，是用户在快手数据库中的“身份证号”。
  • 稳定性：即使你修改了快手昵称、头像等信息，这个User ID也不会变。
  • 用途：主要用于服务器端API调用、数据库查询、数据分析等后端业务逻辑，开发者通过User ID来精确地操作指定用户的数据。
• 获取方式：通常通过登录授权后，快手服务器返回的access_token等信息中会包含这个User ID。

快手快手ID (Kwai ID / kpid)

• 定义：这是用户在快手前端App上展示的、由字母、数字、下划线等组成的唯一标识符（hello_world_123 或 abcde）。
• 特点：
  • 唯一性：每个用户的快手ID也是唯一的。
  • 可读性：相比一长串数字，它更易于记忆和传播。
  • 用途：主要用于前端展示、用户搜索、页面跳转（在App内打开 https://www.kuaishou.com/ 后面直接跟快手ID，就能访问到该用户主页）。
• 获取方式：可以直接从用户主页的URL中获取，或者在用户授权后，通过某些API直接返回。

总结对比

如何进行转换？

核心结论：目前没有公开的、可以直接通过User ID查询到Kwai ID的API接口。

这种转换通常发生在用户授权登录的场景中，以下是标准的流程：

场景：用户通过你的应用登录快手

这是获取两种ID（以及它们之间的关联）最常见和最可靠的方式。

流程如下：

1. 引导用户授权：

   • 你的应用引导用户进入快手登录授权页面。
   • 用户点击“授权登录”，同意你的应用获取其基本信息。

2. 获取临时授权码：

   • 快手服务器会回调你预先配置好的redirect_uri，并在URL参数中返回一个临时的code。

3. 用code换取access_token：

   • 你的后端服务器使用上一步获取的code，以及你的AppID和AppSecret，向快手服务器的Token API发起请求。
   • 请求示例 (POST)：

     https://open.kuaishou.com/oauth2/access_token

   • 请求参数：
     • client_id: 你的AppID
     • client_secret: 你的AppSecret
     • grant_type: authorization_code
     • code: 第一步获取的临时授权码
     • redirect_uri: 你的回调地址

4. 获取关键信息：

   
   （图片来源网络，侵删）
   • 如果请求成功,快手服务器会返回一个JSON响应，其中包含你需要的所有信息。
   • 返回的JSON示例：

     {
       "access_token": "xxxxxxxxxxxxxxxxxxxxxxxx",
       "expires_in": 86400,
       "kpid": "hello_world_123",      // **这里直接返回了快手快手ID**
       "open_id": "1234567890",        // **这里返回的就是快手用户ID**
       "refresh_token": "yyyyyyyyyyyyyyyyyyyyyyyy"
     }

从这个响应中，你可以同时得到：

• 快手用户ID (User ID / uid): open_id 字段的值 (1234567890)
• 快手快手ID (Kwai ID / kpid): kpid 字段的值 (hello_world_123)

所谓的“转换”，实际上是在用户授权登录这个过程中，快手服务器一次性将两种ID都返回给了你的应用，你不需要自己进行转换，而是直接接收即可。

重要提醒

• 没有独立转换API：不要试图去寻找一个 User ID -> Kwai ID 或 Kwai ID -> User ID 的独立API，快手官方没有提供这样的服务，这样做也无法保证数据的实时性和准确性。
• 依赖授权流程：所有合法的ID获取和关联，都必须通过标准的OAuth2.0授权流程来完成。
• 存储关联：在你的应用数据库中，建议将这两种ID都存储下来，用open_id (User ID) 作为你系统里用户的唯一标识，因为它永不改变，用kpid (Kwai ID) 用于前端展示和与快手生态的交互。

希望这个详细的解释能帮助你完全理解快手的两种ID以及它们之间的关系！