CCCHH/spaceapid
CCCHH/spaceapid
2
4
Fork 0
Code Issues 6 Pull requests 1 Projects Releases 1 Packages Activity

Refactoring #34

Merged
bendodroid merged 10 commits from :Bendodroid-refactoring into main 2024-05-26 21:06:30 +02:00
Conversation 1 Commits 10 Files changed 17 +10 -4
1 changed files with 10 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files
Showing only changes of commit b98174c7da - Show all commits

Update README.md with note about URL paths

Prev Next
Bendodroid 2024-02-13 19:48:18 +01:00
commit b98174c7da
Signed by: bendodroid
GPG key ID: 3EEE19A0F73D5FFC

14
README.md
View file

@ -3,7 +3,7 @@
`spaceapid` serves a [SpaceAPI](https://spaceapi.io)-compatible JSON on port 8080: `spaceapid` serves a [SpaceAPI](https://spaceapi.io)-compatible JSON on port 8080:
```shell ```shell
$ curl -X GET http://[::1]:8080 | jq $ curl http://[::1]:8080 | jq
{ {
"api_compatibility": [ "api_compatibility": [
"14" "14"
@ -26,7 +26,7 @@ The config consists of three parts:
- `"response"` - `"response"`
- The static (pre-filled) parts of the response - The static (pre-filled) parts of the response
See [Running](#running) for details. See [Running](#Running) for details.
## Updating values ## Updating values
@ -37,12 +37,18 @@ curl -X PUT -u user:password -d true http://[::1]:8080/state/open
``` ```
The same is true for the endpoints for sensors configured under `"dynamic"`. The same is true for the endpoints for sensors configured under `"dynamic"`.
Currently only `temperature` and `humidity` are implemented. Currently only the sensors with the `value/unit/location/name/description` schema are implemented.
At the time of writing this includes `temperature`, `barometer`, `humidity`, `beverage_supply`, `power_consumption`,
and `account_balance`.
Out-of-spec sensors may also be used as long as they share the same schema.
```shell ```shell
curl -X PUT -u user:password -d 23.42 http://[::1]:8080/sensors/{temperature,humidity}/location[/name] curl -X PUT -u user:password -d 23.42 http://[::1]:8080/sensors/{temperature,humidity,...}[/location[/name]]
``` ```
As can be seen in the example, the http urls are generated from sensor type and optionally `location` and `name`.
Depending on sensor type `location` might be required for your sensors, see the schema for details.
## Building ## Building
See the `go.mod` file for minimum required Go version. See the `go.mod` file for minimum required Go version.