/v1/evidence-types/resolve

POST

/v1/evidence-types/resolve

curl --request POST \
  --url https://example.com/v1/evidence-types/resolve \
  --header 'Content-Type: application/json' \
  --data '{ "jurisdiction": "https://example.com", "requirementId": "https://example.com" }'

Request Body^required

Media typeapplication/json

object

jurisdiction

string format: uri

>= 1 characters <= 4096 characters /^[A-Za-z][A-Za-z0-9+.-]*:/

requirementId

required

string format: uri

>= 1 characters <= 4096 characters /^[A-Za-z][A-Za-z0-9+.-]*:/

Example ^generated

{
  "jurisdiction": "https://example.com",
  "requirementId": "https://example.com"
}

Responses

200

Complete exact mapping result

Media typeapplication/json

object

alternatives

required

Array<object>

0 <= 1000 items

object

evidenceTypeIds

required

Array<string>

>= 1 items <= 128 items unique items

evidenceTypeListId

required

string format: uri

>= 1 characters <= 4096 characters /^[A-Za-z][A-Za-z0-9+.-]*:/

mappingAuthorityId

required

string format: uri

>= 1 characters <= 4096 characters /^[A-Za-z][A-Za-z0-9+.-]*:/

mappingId

required

string format: uri

>= 1 characters <= 4096 characters /^[A-Za-z][A-Za-z0-9+.-]*:/

jurisdiction

string format: uri

>= 1 characters <= 4096 characters /^[A-Za-z][A-Za-z0-9+.-]*:/

mappingRevision

required

string

>= 71 characters <= 71 characters /^sha256:[0-9a-f]{64}$/

requirementId

required

string format: uri

>= 1 characters <= 4096 characters /^[A-Za-z][A-Za-z0-9+.-]*:/

Example ^generated

{
  "alternatives": [
    {
      "evidenceTypeIds": [
        "https://example.com"
      ],
      "evidenceTypeListId": "https://example.com",
      "mappingAuthorityId": "https://example.com",
      "mappingId": "https://example.com"
    }
  ],
  "jurisdiction": "https://example.com",
  "mappingRevision": "example",
  "requirementId": "https://example.com"
}

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.

422

Complete result 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.