Read enabled service authority metadata

GET

/service-endpoint-authority

const url = 'https://auth.example.invalid/service-endpoint-authority';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://auth.example.invalid/service-endpoint-authority

Requires service endpoints enabled; disabled route returns 404 before other guards. Origin is refused even for GET. This metadata grants no authority.

Responses

200

Successful response.

application/json

object

required

Allowed value: 1

kind

required

Allowed value: service-endpoint-authority-info

space

required

string

>= 1 characters

accountPublicKey

required

string

>= 1 characters

issuer

required

string

>= 1 characters

keys

required

Array<object>

<= 16 items

object

kty

required

Allowed value: OKP

crv

required

Allowed value: Ed25519

kid

required

string

>= 1 characters

required

string

>= 1 characters

Example

{
  "v": 1,
  "kind": "service-endpoint-authority-info",
  "keys": [
    {
      "kty": "OKP",
      "crv": "Ed25519"
    }
  ]
}

Headers

Cache-Control

string

Allowed value: no-store

400

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

application/json

object

error

required

string

code

string

outcome

string

Allowed values: not-executed executed unknown

Example

{
  "outcome": "not-executed"
}

403

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

application/json

object

error

required

string

code

string

outcome

string

Allowed values: not-executed executed unknown

Example

{
  "outcome": "not-executed"
}

404

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

application/json

object

error

required

string

code

string

outcome

string

Allowed values: not-executed executed unknown

Example

{
  "outcome": "not-executed"
}

405

JSON error. Route guards run before proof evaluation; parser failures are 400 and byte overflow is 413. An unexpected failure is 400 unless a route handles it separately.

application/json

object

error

required

string

code

string

outcome

string

Allowed values: not-executed executed unknown

Example

{
  "outcome": "not-executed"
}

503

Public admission cap (64 in flight), 10 second request deadline, or a route-specific unavailable read/effect. A service authority 503 may follow a binding; retain the request identity.

application/json

object

error

required

string

code

string

outcome

string

Allowed values: not-executed executed unknown

Example

{
  "outcome": "not-executed"
}