API 页面显示用户 ID 和 API 令牌,对于 Android 应用程序来说显示 QR 码。这些用户凭证通常用以指示以及验证 Habitica 程序和扩展中的详细信息。在网页中,可以从用户图标菜单中的设置选项中访问该页面。或者在应用程序中,可以点击菜单页面右上角的设置图标然后选择 API 选项来访问它。
用户ID (UID)[]
用户ID或通用唯一识别码(UUID)是一个每个用户在注册之后,会获得的独特的复杂的十六位进制数,类似于用户名。然而,不同与用户名,将其分配给用户后将无法更改。
以下情况你会需要它:
- 加入队伍或公会(现在也可以使用用户名)
- 需要 Habitica 管理员对你的账户进行更改时
- 在对Habitica做出贡献之后,获得贡献者的福利时
- 在 Github 提交BUG(请注意,通常网页端首选在 Report a Bug guild 中报告错误。推荐在 Github 中报告移动端 Android 应用 以及 iOS 应用 的 Bug,因为这些方法不需要你的用户 ID。)
- 连接扩展和插件。
要查询你的用户ID,
- 网页端:点击用户图标→设置→ API (direct link)
- iOS/Android App:菜单→设置→API→User ID(点击并拷贝至剪贴板)
要在网页中查找其它玩家的ID,在酒馆里闲谈或者任意聊天界面中点击玩家的角色名。浏览器的地址栏中会出现一个新的格式为 https://habitica.com/profile/用户ID
的 URL(例如,WikiFAQ bot 的角色信息页面为 https://habitica.com/profile/29bfa638-cb88-40e8-a0d0-48f455e7b2bd)。用户ID部分的 URL 为该用户的用户 ID。如果你已经与他们在同一个队伍中,你可以在队伍页面的成员框中单击他们的名字以查看他们的角色信息。如果你在此弹窗打开时刷新浏览器或者打开一个新标签页,你会离开聊天室并在全屏中看到该用户的角色信息。该功能目前在移动端不可用。
API令牌 []
API令牌是一段独特的,由你的用户名计算出的一段安全代码。它类似于账户密码所以请保存好它并且永远不要和不值得信任的程序或者人共享它。如果你不小心在公共空间或不值得信赖的来源中分享来你的API令牌,你可以在 Report a Bug Guild 或者发送邮件至admin@habitica.com以更改你的API令牌。
要查询你的API令牌,
- 网页端:点击用户图标→设置→API(直达链接)
- iOS/Android App:菜单→设置→API→API Key(点击并拷贝至剪贴板)
要查看API令牌,点击设置→API(直达链接)。
第三方应用[]
在网站上,API 页面的第三方应用部分包含可以与 Habitica 集成的应用链接以及每个应用用途的说明。
Webhooks[]
本部分允许用户自定义Webhook,当用户的Habitica账户发生特定的操作时(例如,完成待办事项),将会激活其他网站上的脚本。由于不正确的的 URL 链接会导致错误或者使 Habitica 速度变慢,因此在使用此功能的时候请小心。更多详情,请查看Webhook。
QR码[]
QR码 是以图形可扫描格式表示你的用户 ID。QR码不包含你的 API 令牌,而是包含以下 URL:https://habitica.com/qr-code/user/[用户 ID]
.
例如,WikiFAQ bot(用户 ID:29bfa638-cb88-40e8-a0d0-48f455e7b2bd)的 QR码为:https://habitica.com/qr-code/user/29bfa638-cb88-40e8-a0d0-48f455e7b2bd
.
目前,在游戏中生产QR码的唯一方法是使用 Android 应用,选择 菜单 > 设置 > API > User ID。如果无法访问 Android 应用,则可以使用外部网站或者应用生成 QR码。