Ga naar inhoud
buildinglinksbuildinglinks

Verify a disclosed bundle

POST
/api/v1/disclosures/{id}/verify
curl --request POST \
  --url https://example.com/api/v1/disclosures/example/verify \
  --cookie bl_authority_session=<bl_authority_session>

Checks the bundle: signatures, the hash chain, anchors and their qualified timestamps, and the DID histories, against what the authority itself witnessed (decisions #60). Changes nothing.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

The id of the disclosure.

Responses

Section titled “Responses”

200

Section titled “200”

OK.

Media typeapplication/json

The outcome of verifying a bundle: ok when every check passed.

object
ok
required
boolean
checks
required
Array<object>

One check of a verification.

object
name
required
string
ok
required
boolean
detail
required
string

Example generated

{
  "ok": true,
  "checks": [
    {
      "name": "example",
      "ok": true,
      "detail": "example"
    }
  ]
}

401

Section titled “401”

No valid session, DPoP-bound token or API key.

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}

403

Section titled “403”

The caller lacks the role this operation needs; or a change with the session cookie came from a page of another site (cross_site_request, decisions #83).

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}

404

Section titled “404”

Not found.

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}