The endpoint to work with evaluated metadata and content of a specific zettel is /z/{ID}, where {ID} is a placeholder for the zettel identifier.
For example, to retrieve some evaluated data about this zettel you are currently viewing in Sz encoding, just send a HTTP GET request to the endpoint /z/00001012053500 If authentication is enabled, you must include the a valid access token in the Authorization header with the query parameter enc=sz. If successful, the output is a symbolic expression value:
# curl 'http://127.0.0.1:23123/z/00001012053500?enc=sz'
(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 ") (LITERAL-INPUT () "{ID}") (TEXT " is a placeholder for the ") ...
To select another encoding, you must provide the query parameter enc=ENCODING. Others are html, text, and some more. In addition, you may provide a query parameter part=PART to select the relevant part of a zettel.
# curl 'http://127.0.0.1:23123/z/00001012053500?enc=html&part=zettel'
API: Retrieve evaluated metadata and content of an existing zettel in various encodings
API: Retrieve evaluated metadata and content of an existing zettel in various encodings
The endpoint to work with evaluated metadata and content of a specific zettel is /z/{ID},
...
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.