space.highport.manage.validate

Validate a site or tile record before writing it and, for an authorized caller, prepare bard to serve it. Returns the AT-URI and CID the record will have, and the canonical record to write with putRecord at that key.

Details · procedure
Kindprocedure
Authoritymanage.highport.space
Indexed

Procedure

procedure · POST

Input

application/json

dryRun

boolean

Validate only, without preparing.

record

requiredunknown

A space.highport.sites.site or space.highport.sites.tile record, including $type.

rkey

string

Required for a site (the hostname). For a tile: an existing rkey for a new version, a TID the client chose, or absent to let bard mint one.

space

string · at-uri

Validate as a record in this space. The caller must be its authority.

Output

application/json

cid

string · cid

entryCount

integer

errors

requiredarray

expiresAt

string · datetime

missingBlobs

requiredarray
itemsref

parameterErrors

requiredarray

prepared

requiredboolean

reason

string
  • knownValues: DomainNotVerified | TileAuthorNotPermitted | PreparedQuotaExceeded | SpacePreparationUnsupported | DryRun

record

unknown

The record as bard will serialize it. Write it exactly as returned.

totalBytes

integer

uri

string · at-uri

valid

requiredboolean

Errors

InvalidRecordKey

A site without an rkey, or an rkey that is not a canonical hostname or valid TID.

TileNotReady

The bound tile is still pending publication and cannot be bound yet.

SpaceNotFound

Bard is not connected to that space.

NotSpaceAuthority

Only the space's authority may publish in it.

RateLimitExceeded

Too many preparations this hour.