栖息地


这种集成使您可以监视和管理栖息地的个人资料。这种整合公开了Habitica的API作为家庭助必威是什么理服务。它支持多个用户,并允许您自动检查自己的习惯和日常任务或使用家庭助理施放魔法。必威是什么

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

播放器数据:允许您从栖息地在家庭必威是什么助理中。将可用以下传感器:

  • 玩家的名字
  • 玩家的健康点
  • 球员的最大健康
  • 玩家的法力点
  • 玩家的最大法力值点
  • 玩家的经验
  • 球员的经验到一个新的水平
  • 球员的水平
  • 玩家的金色碎片
  • 球员的课

任务:允许您从中查看和监视您的任务栖息地在家庭必威是什么助理中。将可用以下传感器:

  • 习惯
  • 每天的任务
  • 待办事项
  • 奖励

配置

可以通过使用此my按钮来通过用户界面添必威体育存款加Habi必威是什么tica:可以通过用户界面完成:

手动配置步骤

在运行时,您可以通过Habitica的用户名​​来为每个用户使用API​​。您可以通过通过姓名关键,将使用此值代替用户名。如果您托管了自己的Habtica实例,则可以在其中指定一个URLURL钥匙。

配置变量

API_USER 细绳 必需的

Habitica的API用户ID。可以从中获取此值账户设置

api_key 细绳 必需的

Habitica的API密码(令牌)。可以从中获取此值账户设置通过按“显示API令牌”

姓名 细绳 ((可选的,默认:在启动时推导

替代了Habitica的用户名​​。将用于服务电话

URL 细绳 ((可选的

如果您要托管自己的Habitica实例的URL

API服务参数

API接触家庭助理作为一种称为的服务必威是什么Habitica.API_CALL。要调用它,您应该在服务数据中指定此键:

服务数据属性 必需的 类型 描述
姓名 是的 细绳 根据Habotica的用户名configuration.yaml入口。
小路 是的 [细绳] 来自API URL的项目以阵列的形式,并在末尾附加了方法。请参阅下面的示例。
args 地图 任何其他JSON或URL参数参数。请参阅下面的示例,apidoc

成功呼吁这项服务将解雇活动Habitica_api_call_success

事件数据属性 类型 描述
姓名 细绳 从服务数据属性复制。
小路 [细绳] 从服务数据属性复制。
数据 地图 挑剔数据JSON OBOCT HAPITICA的服务器的领域响应API呼叫而返回。有关更多信息,请参见API文档

让我们考虑一些有关如何致电服务的示例。

例如,假设有一个配置栖息地用户平台xxxnotavalidnickxxx与他们各自的API_USERapi_key。让我们通过家庭助理为该用户创建一个新任务(a todo)。必威是什么有一个API电话以此目的。要创建一个新任务,应该击中https://habica.com/api/v3/tasks/user端点邮政使用任务属性的JSON对象请求。因此,让我们打电话给APIHabitica.API_CALL

  • 姓名钥匙变成了xxxnotavalidnickxxx
  • 小路钥匙更棘手。
    • 消除https://habica.com/api/v3/在端点URL的开头。
    • 将其余的斜线分开(/)和附加小写方法在最后。
    • 你应该得到[“任务”,“用户”,“ post”]。为了更好地了解API,建议您尝试使用IPYTHON控制台中的所有API调用使用此软件包
  • args关键或多或少在API文档

结合在一起:致电Habitica.API_CALL与数据

{“姓名”“ xxxnotavalidnickxxx”,,,,“小路”[[“任务”,,,,“用户”,,,,“邮政”],,“ args”{“文本”“使用家庭助理的API”必威是什么,,,,“类型”“去做”}}

这个电话将创建一个新的待办事项xxxnotavalidnickxxx带有文字的帐户使用家庭助理的API必威是什么像这样:

创建的示例任务

也是一个活动Habitica_api_call_success将用以下数据驱动:

{“姓名”“ xxxnotavalidnickxxx”,,,,“小路”[[“任务”,,,,“用户”,,,,“邮政”],,“数据”{“挑战”{},“团体”{“赞同”{“必需的”错误的,,,,“得到正式认可的”错误的,,,,“请求”错误的},,“分配的人”[],,“共享结论”“重复集结”},,“完全的”错误的,,,,“ CollapseCheckList”错误的,,,,“类型”“去做”,,,,“笔记”“”,,,,“标签”[],,“价值”0,,,,“优先”1,,,,“属性”“ str”,,,,“文本”“使用家庭助理的API”必威是什么,,,,“清单”[],,“提醒”[],,“_ID”“ new_task_uuid”,,,,“创建”“ 2018-08-09T18:03:27.759Z”,,,,“更新”“ 2018-08-09T18:03:27.759Z”,,,,“用户身份”“ xxxnotavalidnickxxx的ID”,,,,“ID”“ new_task_uuid”}}
Baidu