/health

GET

/health

curl --request GET \
  --url https://example.com/health

Responses

200

Process is live

400

Invalid request or request body exceeds the configured bound

Media typeapplication/problem+json

One of:

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: request.invalid

detail

required

string

<= 1024 characters

Allowed value: The Discovery request is invalid.

status

required

integer

Allowed value: 400

title

required

string

Allowed value: Invalid request

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/invalid-request

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: request.not-found

detail

required

string

<= 1024 characters

Allowed value: The requested Discovery resource was not found.

status

required

integer

Allowed value: 404

title

required

string

Allowed value: Not found

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/not-found

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: request.result-bound-exceeded

detail

required

string

<= 1024 characters

Allowed value: The complete Discovery result exceeds its configured bound.

status

required

integer

Allowed value: 422

title

required

string

Allowed value: Result bound exceeded

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/result-bound-exceeded

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: service.unavailable

detail

required

string

<= 1024 characters

Allowed value: Registry Discovery is temporarily unavailable.

status

required

integer

Allowed value: 503

title

required

string

Allowed value: Unavailable

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/unavailable

Example

{
  "code": "request.invalid",
  "detail": "The Discovery request is invalid.",
  "status": 400,
  "title": "Invalid request",
  "type": "https://id.registrystack.org/problems/registry-discovery/invalid-request"
}

Headers

traceparent

required

string

>= 55 characters <= 55 characters /^00-(?!0{32}-)[0-9a-f]{32}-(?!0{16}-)[0-9a-f]{16}-[0-9a-f]{2}$/

Canonical W3C Trace Context version 0; the trace identifier equals the problem traceId.

503

Request exceeded the configured time limit or the response could not be produced

Media typeapplication/problem+json

One of:

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: request.invalid

detail

required

string

<= 1024 characters

Allowed value: The Discovery request is invalid.

status

required

integer

Allowed value: 400

title

required

string

Allowed value: Invalid request

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/invalid-request

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: request.not-found

detail

required

string

<= 1024 characters

Allowed value: The requested Discovery resource was not found.

status

required

integer

Allowed value: 404

title

required

string

Allowed value: Not found

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/not-found

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: request.result-bound-exceeded

detail

required

string

<= 1024 characters

Allowed value: The complete Discovery result exceeds its configured bound.

status

required

integer

Allowed value: 422

title

required

string

Allowed value: Result bound exceeded

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/result-bound-exceeded

object

object

code

required

string

<= 128 characters /^[a-z][a-z0-9-]*[.][a-z][a-z0-9-]*$/

Allowed value: service.unavailable

detail

required

string

<= 1024 characters

Allowed value: Registry Discovery is temporarily unavailable.

status

required

integer

Allowed value: 503

title

required

string

Allowed value: Unavailable

traceId

required

string

>= 32 characters <= 32 characters /^[0-9a-f]{32}$/

Allowed value: 00000000000000000000000000000000

type

required

string format: uri

Allowed value: https://id.registrystack.org/problems/registry-discovery/unavailable

Example

{
  "code": "request.invalid",
  "detail": "The Discovery request is invalid.",
  "status": 400,
  "title": "Invalid request",
  "type": "https://id.registrystack.org/problems/registry-discovery/invalid-request"
}

Headers

traceparent

required

string

>= 55 characters <= 55 characters /^00-(?!0{32}-)[0-9a-f]{32}-(?!0{16}-)[0-9a-f]{16}-[0-9a-f]{2}$/

Canonical W3C Trace Context version 0; the trace identifier equals the problem traceId.