API: Retrieve parsed metadata and content of an existing zettel in various encodings

00001012053600 · Info · (manual) · #api #manual #zettelstore (all)

The endpoint to work with parsed metadata and content of a specific zettel is /z/{ID}, where {ID} is a placeholder for the zettel identifier.

A parsed zettel is basically an unevaluated zettel: the zettel is read and analyzed, but its content is not evaluated. By using this endpoint, you are able to retrieve the structure of a zettel before it is evaluated.

For example, to retrieve some data about this zettel you are currently viewing, just send a HTTP GET request to the endpoint /z/000010120536001 with the query parameter parseonly (and other appropriate query parameter). For example:

# curl 'http://127.0.0.1:23123/z/00001012053600?enc=sz&parseonly'
(BLOCK (PARA (TEXT "The ") (LINK-ZETTEL () "00001012920000" (TEXT "endpoint")) (TEXT " to work with parsed metadata and content of a specific zettel is ") (LITERAL-INPUT () "/z/{ID}") (TEXT ", where ") ...

Similar to retrieving an encoded zettel, you can specify an encoding and state which part of a zettel you are interested in. The same default values applies to this endpoint.

HTTP Status codes

200

Retrieval was successful, the body contains an appropriate data value.

400

Request was not valid.
There are several reasons for this. Maybe the zettel identifier did not consist of exactly 14 digits or enc / part contained illegal values.

403

You are not allowed to retrieve data of the given zettel.

404

Zettel not found. You probably used a zettel identifier that is not used in the Zettelstore.

  1. If authentication is enabled, you must include the a valid access token in the Authorization header ↩︎