Recommend programmatic healthcheck mechanism for Cloud API?


#1

The Cloud API appears to not include a generic healthcheck endpoint.

Is there one?

Particle’s status dashboard reports on the state of the API among other services but the underlying mechanism to generate the results appears not surfaced to developers.

I can make an authenticated request that results in a 200, but I’d prefer a simpler check:

curl \
--silent \
--request GET \
--header "Authorization: Bearer ${TOKEN}" \
 --write-out "%{http_code}" \
--output /dev/null \
https://api.particle.io/v1/devices

Checking https://api.particle.io results in a 302 and with --location provides an HTML (200) with the redirect:

curl \
--silent \
--location \
--request GET \
--write-out "%{http_code}" \
https://api.particle.io

Trying to reference this location yields a 404:

curl \
--silent \
--request GET \
--write-out "%{http_code}"
https://api.particle.io/reference/device-cloud/api

{"ok":false,"error":"Not Found"}
404

Same with /v1 and /v1/