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
- Response
- Sample Request
- Sample Response
- Errors
name | type | desc |
---|---|---|
ok | bool | Should always be |
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
- Response
- Sample Request
- Sample Response
- Errors
name | type | desc |
---|---|---|
go | string | The version of Go used to build the system. |
commit | string | 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.