Background check in from the app (device key): location, and whether to ring or show a message
POST
/v1/station/device/pingFactory API keyBase URL api.skuflo.ioAuth: x-station-id and x-device-key headers (from POST /v1/station/device-key). Answers find (ring until this time) and message (waiting for Got it).
Body parameters#
| Name | Type | Description |
|---|---|---|
geooptional | object | · |
latrequired | number | · |
lngrequired | number | · |
accuracyoptional | number | · |
atoptional | string | · |
app_stateoptional | string | · One of "active", "background" |
Responses#
| Status | Meaning |
|---|---|
| 200 | Success. An example body is in the column on the right. |
Other errors#
| Status | Meaning |
|---|---|
| 401 | No key, or the key is not recognised. |
| 402 | billing_required. Reading always works, but this is a write and stops once a trial ends or a plan is cancelled. |
| 403 | The key is valid but its role cannot do this. |
| 422 | The body failed validation. The response lists every problem at once. |
| 429 | More than 600 requests a minute. Wait retry-after seconds. |