space.highport.manage.validate

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

Details · procedure
Kindprocedure
Authoritymanage.highport.space
Indexed

Showing version bafyreicde37d6dtejczxjhpmzvykgqrk4aqfw75hzcmwynnqcm6vjwsxya. Show the latest

Procedure

procedure · POST

Input

application/json

dryRun

boolean

Validate only; never prepare.

record

requiredunknown

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

rkey

string

Required for a site (the hostname). For a tile: an existing rkey for a new version, a TID the client holds, or absent to have 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; submit it verbatim.

totalBytes

integer

uri

string · at-uri

valid

requiredboolean

Errors

InvalidRecordKey

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

TileNotReady

The bound tile is known only as 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.