📘

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"
  }
]