GET /healthcheck
The GET /healthcheck endpoint provides a simple mechanism to verify that the Chinmina Bridge service is running and accepting HTTP requests.
For documentation of token-issuing endpoints, see POST /token, POST /git-credentials, and Profile-Scoped Endpoints.
Purpose
Section titled “Purpose”This endpoint is designed for use with Kubernetes liveness probes, load balancer health checks, and monitoring systems. It provides a lightweight, unauthenticated health check that validates only HTTP server functionality, not external dependencies.
Request format
Section titled “Request format”This endpoint is not authenticated and takes no parameters.
Response format
Section titled “Response format”The endpoint returns an HTTP status code with no response body:
| Status Code | Meaning |
|---|---|
200 OK | Service is running and accepting requests |
503 Service Unavail | Service is not ready (typically during startup/shutdown) |
Example request
Section titled “Example request”curl http://localhost:8080/healthcheckError responses
Section titled “Error responses”This endpoint does not return JSON error responses. HTTP status codes are the sole indicator of health.