misc.adoc 928 B

123456789101112131415161718192021222324252627282930
  1. = Misc API calls
  2. == Example API call: Get the dashboard buttons
  3. `GetDashboard` returns the dashboard and its action buttons, including each action's `bindingId`. Send an empty object for the default dashboard, or set `title` to request a specific dashboard.
  4. .curl
  5. ----
  6. user@host: curl http://olivetinServer:1337/api/GetDashboard --json '{}'
  7. ----
  8. == Example API call: readyz Healthcheck
  9. This is useful for configuring healthchecks in docker containers, or on Kubernetes. The simplest option is the plain HTTP `/readyz` endpoint (not under `/api/`), which works with a `GET` request;
  10. .curl
  11. ----
  12. user@host: curl http://olivetinServer:1337/readyz
  13. OK. Single HTTP Frontend is ready.
  14. ----
  15. There is also an API method, `GetReadyz`;
  16. .curl
  17. ----
  18. user@host: curl http://olivetinServer:1337/api/GetReadyz --json '{}'
  19. {"status":"OK"}
  20. ----
  21. Either will respond with a `200` status to indicate that OliveTin is up, or it will timeout.