veil

Open the explainer pages

The index of the explainer pages: Veil compared with Keybase, Keyoxide and PGP keyservers, public key directories, checking a Discord account, signing releases, organisations and communities.

GET/learn
Access
Public access
Client
Open as a page

Parameters#

NameLocationMeaning
langQueryen or it. English is the default.

Request examples#

cURL
curl -fsS 'https://veil.pub/learn'

Response#

HTTP 200text/html

A page listing each explainer with its description, in English or Italian, with a CollectionPage and a BreadcrumbList in JSON-LD.

Response headers#

HeaderValueMeaning
Content-Typetext/htmlUse the declared media type before choosing a parser.
DateHTTP dateServer time. Compare it with your clock when signing requests.
Retry-Afterinteger seconds, on rate_limited or busyWait at least this long before retrying. Other 429/503 codes do not necessarily include it.

Usage notes#

  • Indexable, in the sitemap. The Italian address adds ?lang=it, and hreflang links the two.

Errors#

API errors return an error object. Use error.code for program logic; error.message is English text for people and can change. Response and error guide

HTTPCodeMeaning and next step
429rate_limited

An anonymous, signed-request or API-key allowance was exceeded.

Wait at least Retry-After seconds. Share a queue and retry budget across your workers.

500internal_error

An unexpected server error occurred. Internal details are not returned.

Retry reads with bounded backoff. Check write results before sending a new signed operation.

503busy

The application has reached a temporary concurrency or database limit.

Wait Retry-After seconds and retry with bounded backoff.