导入
基本用户信息
学习如何使用 Twitch API 获取用户详情。
...
用户端点概览
代码示例
1https://api.twitch.tv/helix/users
| 参数 | 类型 | 分类 | 描述 |
|---|---|---|---|
| id | 字符串 | 可选 | 要获取详细信息的用户 ID。最多可提供 100 个用户 ID。 |
| login | 字符串 | 可选 | 要获取详细信息的用户登录名。最多可提供 100 个登录名。 |
1// 导入所需库 2import fetch from "node-fetch"; 3 4// 定义端点 URL 5const endpointUrl = new URL("https://api.twitch.tv/helix/users"); 6 7// 定义请求头参数 8const headerParameters = { 9 Authorization: "Bearer {{USER_ACCESS_TOKEN}}", 10 "Client-Id": "{{CLIENT_ID}}", 11}; 12 13// 设置 API 请求选项 14const options = { 15 method: "GET", 16 headers: headerParameters, 17}; 18 19// 定义异步函数,用于发起 API 请求并获取用户信息 20async function fetchUserDetails() { 21 try { 22 const response = await fetch(endpointUrl, options); 23 printResponse(response); 24 } catch (error) { 25 printError(error); 26 } 27} 28 29// 调用函数获取用户信息 30fetchUserDetails();
1import fetch from "node-fetch"; 2 3const endpointUrl = new URL("https://api.twitch.tv/helix/users"); 4 5const headerParameters = { 6 Authorization: "Bearer {{APP_ACCESS_TOKEN}}", 7 "Client-Id": "{{CLIENT_ID}}", 8}; 9 10// 使用 id 和 login 查询参数 11const queryParameters = new URLSearchParams({ 12 id: "{{USER_ID}}", 13 login: "twitch", 14}); 15 16const options = { 17 method: "GET", 18 headers: headerParameters, 19}; 20 21async function fetchUserDetails() { 22 try { 23 endpointUrl.search = queryParameters; 24 const response = await fetch(endpointUrl, options); 25 printResponse(response); 26 } catch (error) { 27 printError(error); 28 } 29} 30 31fetchUserDetails();
| 属性 | 类型 | 描述 |
|---|---|---|
| id | 字符串 | 用户的唯一标识 ID。 |
| login | 字符串 | 用户的登录名。 |
| display_name | 字符串 | 用户的显示名称。 |
| type | 字符串 | 用户类型。可能值为 "staff"、"admin" 和 "global_mod"。若用户不属于以上任何类型,则该值为空字符串 ""。 |
| broadcaster_type | 字符串 | 用户的主播类型。可能值为 "partner" 和 "affiliate"。若用户不属于以上任何类型,则该值为空字符串 ""。 |
| description | 字符串 | 用户在账户中设置的公开简介。 |
| profile_image_url | 字符串 | 用户头像的静态图片链接。 |
| offline_image_url | 字符串 | 用户离线时显示的直播占位图静态链接。 |
| view_count | 整数 | 用户频道累计的总观看次数。 |
| 字符串 | 用户的已验证邮箱地址。仅当使用带有 user:read:email 权限的用户访问令牌时才会返回。 | |
| created_at | 字符串 | 用户账户创建时间的 UTC 时间戳。 |