Habitica


这种集成允许您监视和管理您的Habitica配置文件。此集成公开Habitica的API作为家庭助必威是什么理服务。它支持多个用户,并允许您自动检查您的习惯和日常任务或使用家庭助理铸造魔术。必威是什么

目前在家庭助理中支持以下设备类型:必威是什么

玩家数据:允许你查看和监控你的玩家数据Habitica在国内必威是什么的助理。可提供以下传感器:

  • 球员的名字
  • 球员的健康点
  • 玩家的最大健康
  • 玩家的法力点
  • 玩家的最大法力点
  • 玩家的经验
  • 玩家体验到下一个关卡
  • 球员的水平
  • 玩家的金币
  • 球员级别

任务:允许您查看和监控您的任务Habitica在国内必威是什么的助理。可提供以下传感器:

  • 习惯
  • 日常任务
  • 待办事项
  • 奖励

配置

将Habitica添加到你的家庭助理实必威体育存款例可以通过必威是什么用户界面完成,通过使用这个My按钮:

手动配置步骤

在运行时,你将能够通过每个用户的Habitica的用户名为他们使用API。你可以通过传递的名字键时,将使用此值而不是用户名。如果你正在托管自己的Habitica实例,你可以在url关键。

配置变量

api_user 字符串 要求

Habitica的API用户ID。这个值可以从中获取帐户设置

api_密钥 字符串 要求

Habitica的API密码(令牌)。这个值可以从中获取帐户设置通过按“Show API令牌”

的名字 字符串 可选, default:在启动时推断

重写Habitica的用户名。将用于服务呼叫

url 字符串 可选

URL到您的Habitica实例,如果您正在托管自己的

API服务参数

API作为一个被调用的服务公开给Home A必威是什么ssistanthabitica.api_调用。要调用它,你应该在服务数据中指定以下关键字:

服务数据属性 要求 类型 描述
的名字 字符串 Habitica的用户名configuration.yaml条目。
路径 (字符串) API URL中的项以数组的形式出现,并在末尾附加了方法。参见下面的示例。
args 没有 地图 任何额外的JSON或URL参数参数。参见下面的例子apidoc

成功调用该服务将触发一个事件habitica_api_call_success

事件数据属性 类型 描述
的名字 字符串 从服务数据属性复制。
路径 (字符串) 从服务数据属性复制。
数据 地图 反序列化数据用于响应API调用的JSON对象Habitica服务器返回的字段。有关更多信息,请参见API文档

让我们考虑一些关于如何调用服务的示例。

例如,假设有一个配置的habitica平台用户xxxNotAValidNickxxx与各自的api_userapi_密钥. 让我们通过Home Assistant为此用户创建一个新任务(todo)。有一个必威是什么API调用为这个目的。要创建一个新任务,应该击中它https://habitica.com/api/v3/tasks/user端点与帖子使用带有任务属性的JSON对象请求。让我们调用这个APIhabitica.api_调用

  • 的名字钥匙变成xxxNotAValidNickxxx
  • 路径关键是棘手。
    • 删除https://habitica.com/api/v3/在端点URL的开头。
    • 将剩下的用斜杠(/)和分割附加小写方法在最后。
    • 你应该得到[“任务”、“用户”、“发布”]。为了更好地了解API,建议您尝试IPython控制台中的所有API调用使用这个包
  • args钥匙或多或少是在API文档

结合在一起:呼叫habitica.api_调用与数据

{" name": "xxxNotAValidNickxxx", "path": ["tasks", "user", "post"], "args": {"text": "Use API from 必威是什么Home Assistant", "type": "todo"}}

这个调用将创建一个新的todo onxxxNotAValidNickxxx使用文本的帐户使用来自Home Assi必威是什么stant的API是这样的:

示例中创建的任务

也是一件大事habitica_api_call_success将以以下数据解雇:

{" name": "xxxNotAValidNickxxx", "path": ["tasks", "user", "post"], "data": {" challenge": {}, "group": {"approval": {"required": false, "approved": false, "requested": false}, " assigndusers ": [], "sharedCompletion": "recurringCompletion"}, "completed": false, "collapseChecklist": false, "type": "todo", "notes": "", "tags": [], "value":0, "priority": 1, "attribute": "str", "text": "Use API from 必威是什么Home Assistant", "checklist": [], " alerts ": [], "_id": "NEW_TASK_UUID", "createdAt": "2018-08-09T18:03:27.759Z", "updatedAt": "2018-08-09T18:03:27.759Z", "userId": "xxxNotAValidNickxxx's ID", " ID": "NEW_TASK_UUID"}}
Baidu