Home Assistant web services

Go to file

dependabot[bot] d4517961e2 Bump wrangler from 3.90.0 to 3.91.0 (#626 ) Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>		2024-12-02 14:41:03 +01:00
.devcontainer	Bump node from 16 to 20 (#416 )	2023-10-09 14:36:13 +02:00
.github	Bump cloudflare/wrangler-action from 3.12.1 to 3.13.0 (#624 )	2024-12-02 07:19:55 +01:00
src	revert webrtc service (#598 )	2024-10-15 15:58:05 +02:00
tests	revert webrtc service (#598 )	2024-10-15 15:58:05 +02:00
.gitignore	feat(assist): add put wake word training endpoint (#368 )	2023-08-21 15:07:35 +02:00
.nvmrc	Bump node from 16 to 20 (#416 )	2023-10-09 14:36:13 +02:00
LICENSE	Add LICENSE (#22 )	2021-06-03 10:01:25 -07:00
README.md	Add meta data tags (#544 )	2024-07-05 23:22:18 +02:00
package.json	Bump wrangler from 3.90.0 to 3.91.0 (#626 )	2024-12-02 14:41:03 +01:00
tsconfig.json	Enable strict type checking in TS config (#585 )	2024-09-24 16:46:07 +03:00
webpack.config.js	Add initial worker (#1 )	2021-05-14 08:50:44 +02:00
wrangler.toml	Enable strict type checking in TS config (#585 )	2024-09-24 16:46:07 +03:00
yarn.lock	Bump wrangler from 3.90.0 to 3.91.0 (#626 )	2024-12-02 14:41:03 +01:00

README.md

services.home-assistant.io

Home Assistant web services running on CloudFlare workers

whoami

IP Based GEO lookup

Adress structure

[schema]://services.home-assistant.io/whoami/v1/[key]

placeholder	required	description
`schema`	True	Use `http` or `https`
`key`	False	Return a single key from the regular JSON response as text.

Examples

curl -sSL https://services.home-assistant.io/whoami/v1
{
  "ip": "1.2.3.4",
  "city": "Gotham",
  "continent": "Earth",
  "country": "XX",
  "currency": "XXX",
  "latitude": "12.34567",
  "longitude": "12.34567",
  "postal_code": "12345",
  "region_code": "00",
  "region": "Gotham",
  "timezone": "Earth/Gotham",
  "iso_time": "2021-05-12T11:29:15.752Z",
  "timestamp": 1620818956
}

curl -sSL https://services.home-assistant.io/whoami/v1/ip
1.2.3.4

assist

Services used for assist.

Upload wake word training data

curl --location --request PUT 'https://services.home-assistant.io/assist/wake_word/training_data/upload?wake_word=[name]&user_content=[user content]' \
--header 'Content-Type: audio/webm' \
--data '@/data/file.webm'