Lambdas

Creates a lambda

The new lambda is in the free tier and has one version: a copy of the template, or a snippet that says hello if none is given. Nothing is online until a version is deployed (POST /lambdas/{privateKey}/deployment/start, or a save with ?deploy=true). A copy of a demo that keeps records starts with an empty database of its own, switched on; the demo's records are not copied.

The answer holds the editor key (privateKey). It is handed out this once and cannot be recovered: whoever loses it loses the lambda, and whoever finds it may change it.

A publicKey that is asked for is trimmed and lower cased, and must be 3 to 40 characters of a-z, 0-9 and -, neither starting nor ending with a dash. It may not start with demo- or xn--, and a few names are reserved for the platform (www, api, admin, mail and the like). GET /keys/{publicKey} says whether a key can be claimed before trying. Left out, a random key of eight characters is chosen.

post/lambdas

Request

  • Base URL: https://genhttp.dev/api/v1
  • URL: https://genhttp.dev/api/v1/lambdas
  • Auth: none declared

Request body

PublicKeystring nullable

The public key to claim, which names the address: 3 to 40 characters of a-z, 0-9 and dashes. Left out, a random one is chosen.

AcceptedTermsboolean

Whether the terms of the installation (terms of GET /system) were accepted. Nothing is created unless this is true.

Templatestring nullable

What the lambda starts as: the id of a demo, as GET /demos and the starters of GET /system list them, or empty. Left out, empty.

Viewstring nullable

How its editor opens: Full (the default) with the code, files and versions, or Simple - the app, how it is doing and where to ask for a change, for somebody who is not going to read the code. Case does not matter.

Response

The lambda was created. Keep privateKey: it is not handed out again.

PublicKeystring

Names its address below the hosting domain. Not a secret; its owner may change it.

PrivateKeystring

The editor key, which authorizes every call about the lambda. Treat it like a password.

Tierstring

Free, Premium or Demo, assigned by the operator. Decides its limits, whether it is kept online while nobody uses it, and whether it may answer at a domain of its own.

Createdstring date-time

When it was created

Modifiedstring date-time

When something about it last changed: a save, a deployment, a setting

ActiveVersioninteger nullable

The version that is online; absent while nothing is

LatestVersioninteger nullable

The newest version saved, which may be ahead of the one online

PublicUrlstring

Its address below the hosting domain, named after its public key: https://quiz.genhttp.run/. While it answers at a domain of its own, this address sends its visitors on to the domain.

EditorPathstring

Where its editor is on this site: /editor/{privateKey}. Holds the editor key.

DeployedAtstring date-time nullable

When the version online went online; absent while nothing is

DeployedUntilstring date-time nullable

When it is taken offline unless it is visited or edited before then - each visit and each edit moves this on. Absent while it is offline, and for a tier that keeps it online.

KeptUntilstring date-time nullable

When it is deleted unless it is visited or edited before then. Absent for a tier that keeps it.

Domainstring nullable

The domain of its own it is configured to answer at, whether or not its tier lets it

DomainServedboolean

Whether it answers at that domain: it has one, and its tier includes it

Addressstring

Where to link to it: its domain while that is served, publicUrl otherwise

Viewstring

How its editor opens for somebody who has not chosen a view of their own: Full or Simple

GitPathstring

Where it is cloned with git and pushed to, on this site. The versions are the commits of main, the features the other branches. Holds the editor key, like the editor's path.

Changes

No recorded changes to this operation across all 1 revision of this API.