Credential
A Credential is a standing authority a regulator grants a person or entity to perform certain acts in a jurisdiction.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
issuer | string | required | The regulator or registry that grants it. |
jurisdiction | string | required | Where it applies. |
standing | string | Whether it is in good standing, read fresh on every use. |
Object
{
"$id": "https: //api.sb/ patentpad.com/ credentials/ credential_1",
"$type": "Credential",
"issuer": "Example issuer",
"jurisdiction": "US-DE",
"standing": "Example standing"
}Relationships
- A Credential has many Attestations: the Credential the signing Worker held when it signed.
attestations, inversesignedUnder. - A Credential authorizes many Reserved Acts: a Credential lets its holder perform the Reserved Acts the law keeps for it, in its jurisdiction.
authorizes, inverserequires. - A Credential is held by one Worker: a Worker performs a Reserved Act only while it holds the Credential that authorizes it, in good standing.
heldBy, inverseholds. - A Credential is held by supplier one Supplier: the Credentials a Supplier holds decide which Reserved Acts it may perform; standing is read fresh on every use.
heldBySupplier, inverseholds.
Verbs
createCreates a Credential.POST /{namespace}/credentialsgetReturns one Credential by id.GET /{namespace}/credentials/{id}listReturns Credentials, newest first, one page at a time.GET /{namespace}/credentialsupdateChanges the given properties of a Credential.PATCH /{namespace}/credentials/{id}deleteDeletes a Credential; its history is kept.DELETE /{namespace}/credentials/{id}verifyVerify confirms a Credential with the authority that issued it and records when it expires.POST /{namespace}/credentials/{credential}/verify
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Credential.create | Yes | Yes | No | No |
Credential.get | Yes | Yes | Yes | Yes |
Credential.list | Yes | Yes | Yes | Yes |
Credential.update | Yes | Yes | No | No |
Credential.delete | Yes | Yes | No | No |
Credential.verify | Yes | Yes | No | No |
Call it
Verify the latest credential.Example
A state appraiser license is a Credential. A Supplier holding it performs appraisals in that state until the license lapses.