Misc

Assets exposes some miscellaneous APIs for verifying the health (ping) and retrieving information (info) about the system.

Ping

Returns ok if Assets is working properly. This is an endpoint that a health-check would want to monitor. Callers can either use the status code (200) or the basic response.

GET /ping
nametypedesc
okbool

Should always be true.

curl "http://127.0.0.1:5300/ping"
{"ok":true}

The general error section details Assets's error responses as well as detailing all errors, including global errors, such as validation and internal server errors.

Info

Returns information about the system. The information included in the response is not sensitive and should be included in any bug reports.

GET /info
nametypedesc
gostring

The version of Go used to build the system.

commitstring

The commit hash.

curl "http://127.0.0.1:5300/info"
{
  "go": "go1.19",
  "commit": "ce6d5c022ffd7834c6621a3a6522b8316bdf8c00"
}

The general error section details Assets's error responses as well as detailing all errors, including global errors, such as validation and internal server errors.