(BLOCK (PARA (TEXT "All API endpoints conform to the pattern ") (LITERAL-INPUT () "[PREFIX]LETTER[/ZETTEL-ID]") (TEXT ", where:")) (DESCRIPTION () ((LITERAL-INPUT () "PREFIX")) (BLOCK (BLOCK (PARA (TEXT "is the URL prefix (default: ") (FORMAT-QUOTE () (TEXT "/")) (TEXT "), configured via the ") (LITERAL-INPUT () "url-prefix") (TEXT " ") (LINK () (ZETTEL "00001004010000") (TEXT "startup configuration")) (TEXT ",")))) ((LITERAL-INPUT () "LETTER")) (BLOCK (BLOCK (PARA (TEXT "is a single letter that specifies the resource type,")))) ((LITERAL-INPUT () "ZETTEL-ID")) (BLOCK (BLOCK (PARA (TEXT "is an optional 14 digits string that uniquely ") (LINK () (ZETTEL "00001006050000") (TEXT "identify a zettel")) (TEXT "."))))) (PARA (TEXT "The following letters are currently in use:")) (TABLE ((CELL ((align . "center")) (TEXT " Letter")) (CELL () (TEXT "Without zettel identifier")) (CELL () (TEXT "With ") (LINK () (ZETTEL "00001006050000") (TEXT "zettel identifier"))) (CELL () (TEXT "Mnemonic"))) ((CELL ((align . "center")) (LITERAL-INPUT () "a")) (CELL () (TEXT "POST: ") (LINK () (ZETTEL "00001012050200") (TEXT "client authentication"))) (CELL ()) (CELL () (FORMAT-STRONG () (TEXT "A")) (TEXT "uthenticate"))) ((CELL ((align . "center"))) (CELL () (TEXT "PUT: ") (LINK () (ZETTEL "00001012050400") (TEXT "renew access token"))) (CELL ()) (CELL ())) ((CELL ((align . "center")) (LITERAL-INPUT () "r")) (CELL ()) (CELL () (TEXT "GET: ") (LINK () (ZETTEL "00001012053800") (TEXT "references"))) (CELL () (FORMAT-STRONG () (TEXT "R")) (TEXT "eference"))) ((CELL ((align . "center")) (LITERAL-INPUT () "x")) (CELL () (TEXT "GET: ") (LINK () (ZETTEL "00001012070500") (TEXT "retrieve administrative data"))) (CELL ()) (CELL () (TEXT "E") (FORMAT-STRONG () (TEXT "x")) (TEXT "ecute"))) ((CELL ((align . "center"))) (CELL () (TEXT "POST: ") (LINK () (ZETTEL "00001012080100") (TEXT "execute command"))) (CELL ()) (CELL ())) ((CELL ((align . "center")) (LITERAL-INPUT () "z")) (CELL () (TEXT "GET: ") (LINK () (ZETTEL "00001012051200") (TEXT "list zettel")) (TEXT "/") (LINK () (ZETTEL "00001012051400") (TEXT "query zettel"))) (CELL () (TEXT "GET: ") (LINK () (ZETTEL "00001012053300") (TEXT "retrieve zettel"))) (CELL () (FORMAT-STRONG () (TEXT "Z")) (TEXT "ettel"))) ((CELL ((align . "center"))) (CELL () (TEXT "POST: ") (LINK () (ZETTEL "00001012053200") (TEXT "create new zettel"))) (CELL () (TEXT "PUT: ") (LINK () (ZETTEL "00001012054200") (TEXT "update zettel"))) (CELL ())) ((CELL ((align . "center"))) (CELL ()) (CELL () (TEXT "DELETE: ") (LINK () (ZETTEL "00001012054600") (TEXT "delete zettel"))) (CELL ()))) (PARA (TEXT "The full URL will contain either the ") (FORMAT-QUOTE () (TEXT "http")) (TEXT " oder ") (FORMAT-QUOTE () (TEXT "https")) (TEXT " scheme, a host name, and an optional port number.")) (PARA (TEXT "The API examples will assume the ") (FORMAT-QUOTE () (TEXT "http")) (TEXT " schema, the local host ") (FORMAT-QUOTE () (TEXT "127.0.0.1")) (TEXT ", the default port ") (FORMAT-QUOTE () (TEXT "23123")) (TEXT ", and the default empty ") (LITERAL-INPUT () "PREFIX") (TEXT " ") (FORMAT-QUOTE () (TEXT "/")) (TEXT ".") (SOFT) (TEXT "Therefore, all URLs in the API documentation will begin with ") (FORMAT-QUOTE () (TEXT "http://127.0.0.1:23123/")) (TEXT ".")))