Magic resources are specials resources that start with $, and have some special behaviors, like trigger some common task, or update static data. These resources can be used as the others using read and write operations.
Remember to replace THING_TOKEN with the thing token that you got when you activated your thing and $MAGIC_RESOURCE with the magic resource name (see below).
Magic resource handlers are processed asynchronously: mixing various magic resources in a single request may have an unexpected behavior because order might not be respected.
$geo resource
This resource allows the retrieval of the current thing position in GeoJSON format.
curl -i -H "Accept: application/json" \
-X GET "https://api.thethings.io/v2/things/THING_TOKEN/resources/$geo" \
-k
[
{
"key": "$geo",
"value": {
"type": "Point",
"coordinates": [2.154007, 41.390205]
}
}
]
$settings resource
This resource allows the retrieval of the thing settings meta-data storage. It also permits to get a single value at path (in dot separated format).
curl -i -H "Accept: application/json" \
-X GET "https://api.thethings.io/v2/things/THING_TOKEN/resources/$settings.name" \
-k
[
{
"key": "$settings.name",
"value": "My Thing"
}
]