From 7218029b3405581284959b30a357c27a852fe194 Mon Sep 17 00:00:00 2001
From: Pavel Pletenev <cpp.create@gmail.com>
Date: Sat, 8 Sep 2018 14:34:56 +0200
Subject: [PATCH] Docs for Habitica component (#5923)

* Docs for Habitica component (1/2)

Signed-off-by: delphi <cpp.create@gmail.com>

* Added sensor docs. Updated docs to match habitica code.

Signed-off-by: delphi <cpp.create@gmail.com>

* Fix docs according to docs

Signed-off-by: delphi <cpp.create@gmail.com>

* Fix typos and code review

Signed-off-by: delphi <cpp.create@gmail.com>
---
 source/_components/habitica.markdown          | 132 ++++++++++++++++++
 source/_components/sensor.habitica.markdown   |  21 +++
 .../images/screenshots/habitica_new_task.png  | Bin 0 -> 2535 bytes
 source/images/supported_brands/habitica.png   | Bin 0 -> 5677 bytes
 4 files changed, 153 insertions(+)
 create mode 100644 source/_components/habitica.markdown
 create mode 100644 source/_components/sensor.habitica.markdown
 create mode 100644 source/images/screenshots/habitica_new_task.png
 create mode 100644 source/images/supported_brands/habitica.png

diff --git a/source/_components/habitica.markdown b/source/_components/habitica.markdown
new file mode 100644
index 00000000000..fbd51c31267
--- /dev/null
+++ b/source/_components/habitica.markdown
@@ -0,0 +1,132 @@
+---
+layout: page
+title: "Habitica"
+description: "Instructions on enabling Habitica support for your Home Assistant"
+date: 2018-08-09 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: habitica.png
+ha_category: Hub
+ha_version: 0.78
+ha_iot_class: "Cloud Polling"
+---
+
+This component allows you to monitor and manage your Habitica profile. This component exposes the [Habitica's API](https://habitica.com/apidoc/) as a Home Assistant service. It supports multiple users and allows you to automate checking out your habits and daily tasks or casting magics using Home Assistant.
+This component enables usage of [`sensor.habitica` platform.](/components/sensor.habitica/)
+To use the component you should use this example configuration:
+
+```yaml
+# Minimum viable configuration.yaml entry
+habitica:
+  - api_user: 'REPLACE_ME_WITH_YOUR_USER_ID'
+    api_key: 'REPLACE_ME_WITH_YOUR_API_KEY'
+```
+
+You can specify several users, providing `api_user` and `api_key` for each.
+At runtime you will be able to use API for each respective user by their Habitica's username.
+You can override this by passing `name` key, this value will be used instead of the username.
+If you are hosting your own instance of Habitica, you can specify a URL to it in `url` key.
+
+{% configuration %}
+api_user:
+  description: "Habitica's API user ID. This value can be grabbed from [account setting](https://habitica.com/user/settings/api)"
+  required: true
+  type: string
+api_key:
+  description: "Habitica's API password (token). This value can be grabbed from [account setting](https://habitica.com/user/settings/api) by pressing 'Show API token'"
+  required: true
+  type: string
+name:
+  description: "Override for Habitica's username. Will be used for service calls"
+  required: false
+  type: string
+  default: Deduced at startup
+url:
+  description: "URL to your Habitica instance, if you are hosting your own"
+  required: false
+  type: string
+  default: http://habitica.com
+sensors:
+  description: List of sensors to generate for this user. If you don't specify this entry then the default (all sensors) will be generated. If you specify this entry empty then no sensors will be generated.
+  required: false
+  type: list
+  default: all (`name`, `hp`, `maxHealth`, `mp`, `maxMP`, `exp`, `toNextLevel`, `lvl`, `gp`, `class`)
+{% endconfiguration %}
+
+### {% linkable_title API Service Parameters %}
+
+The API is exposed to Home Assistant as a service called `habitica.api_call`. To call it you should specify this keys in service data:
+
+| Service data attribute | Required | Type     |    Description  |
+|----------------------|--------|--------|----------------|
+|  `name`                |  yes     | string   |  Habitica's username as per `configuration.yaml` entry. |
+| `path` | yes | [string] | Items from API URL in form of an array with method attached at the end. See the example below. |
+| `args` | no | map | Any additional json or url parameter arguments. See the example below and [apidoc](https://habitica.com/apidoc/). |
+
+A successful call to this service will fire an event `habitica_api_call_success`.
+
+| Event data attribute |  Type     |    Description  |
+|----------------------|--------|----------------|
+|  `name`                |   string   |  Copied from service data attribute. |
+| `path` | [string] | Copied from service data attribute. |
+| `data` | map | Deserialized `data` field of JSON object Habitica's server returned in response to api call. For more info see [docs](https://habitica.com/apidoc/). |
+
+#### Let's consider some examples on how to call the service.
+
+For example, let's say that there is a configured `habitica` platform for user `xxxNotAValidNickxxx` with their respective `api_user` and `api_key`.
+Let's create a new task (a todo) for this user via Home Assistant. There is an [API call](https://habitica.com/apidoc/#api-Task-CreateUserTasks) for this purpose.
+To create a new task one should hit `https://habitica.com/api/v3/tasks/user` endpoint with `POST` request with a json object with task properties.
+So let's call the API on `habitica.api_call`.
+* The `name` key becomes `xxxNotAValidNickxxx`.
+* The `path` key is trickier.
+    * Remove 'https://habitica.com/api/v3/' at the beginning of the endpoint URL.
+    * Split the remaining on slashes (/) and **append the lowercase method** at the end.
+    * You should get `["tasks", "user", "post"]`. To get a better idea of the API you are recommended to try all of the API calls in IPython console [using this package](https://github.com/ASMfreaK/habitipy/blob/master/README.md).
+* The `args` key is more or less described in the [docs](https://habitica.com/apidoc/).
+
+Combining all together:
+call `habitica.api_call` with data
+```
+{
+  "name": "xxxNotAValidNickxxx",
+  "path": ["tasks", "user", "post"],
+  "args": {"text": "Use API from Home Assistant", "type": "todo"}
+}
+```
+
+This call will create a new todo on `xxxNotAValidNickxxx`'s account with text `Use API from Home Assistant` like this:
+
+![example task created](/images/screenshots/habitica_new_task.png)
+
+Also an event `habitica_api_call_success` will be fired with the following data:
+```
+{
+  "name": "xxxNotAValidNickxxx",
+  "path": ["tasks", "user", "post"],
+  "data": {
+    "challenge": {},
+    "group": {"approval": {"required": false,
+     "approved": false,
+     "requested": false},
+    "assignedUsers": [],
+    "sharedCompletion": "recurringCompletion"},
+    "completed": false,
+    "collapseChecklist": false,
+    "type": "todo",
+    "notes": "",
+    "tags": [],
+    "value": 0,
+    "priority": 1,
+    "attribute": "str",
+    "text": "Use API from Home Assistant",
+    "checklist": [],
+    "reminders": [],
+    "_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"}
+}
+```
diff --git a/source/_components/sensor.habitica.markdown b/source/_components/sensor.habitica.markdown
new file mode 100644
index 00000000000..4e94148bb9f
--- /dev/null
+++ b/source/_components/sensor.habitica.markdown
@@ -0,0 +1,21 @@
+---
+layout: page
+title: "Habitica Sensor"
+description: "Instructions on enabling Habitica support for your Home Assistant"
+date: 2018-08-09 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: habitica.png
+ha_category: Sensor
+ha_iot_class: "Cloud Polling"
+ha_version: 0.78
+---
+
+The `habitica` sensor platform allows you to view and monitor your player data from [Habitica](https://habitica.com/) in Home Assistant.
+
+<p class='note'>
+You must have the [`habitica` component](/components/habitica/)
+configured to use this platform. After configuring that component, sensors specified there will automatically appear.
+</p>
diff --git a/source/images/screenshots/habitica_new_task.png b/source/images/screenshots/habitica_new_task.png
new file mode 100644
index 0000000000000000000000000000000000000000..dd21d3a3b6c8a1c60824ba028f9df04422d14c17
GIT binary patch
literal 2535
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
CPt$e)

literal 0
HcmV?d00001

diff --git a/source/images/supported_brands/habitica.png b/source/images/supported_brands/habitica.png
new file mode 100644
index 0000000000000000000000000000000000000000..a90f684be213adf6285e98e8e5c21671b3f7f52a
GIT binary patch
literal 5677
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
LGwhK~K+^vJ50@73

literal 0
HcmV?d00001