(zettel (meta (back "00001006000000 00001012000000 00001012053600") (backward "00001006000000 00001012000000 00001012053600") (box-number "1") (created "20210726174524") (forward "00001006050000 00001010040100 00001012050200 00001012920000 00001012920500 00001012920510 00001012920516 00001012920519 00001012920800") (modified "20240620171057") (published "20240620171057") (role "manual") (syntax "zmk") (tags "#api #manual #zettelstore") (title "API: Retrieve evaluated metadata and content of an existing zettel in various encodings")) (rights 4) (encoding "") (content "The [[endpoint|00001012920000]] to work with evaluated metadata and content of a specific zettel is ''/z/{ID}'', where ''{ID}'' is a placeholder for the [[zettel identifier|00001006050000]].\n\nFor example, to retrieve some evaluated data about this zettel you are currently viewing in [[Sz encoding|00001012920516]], just send a HTTP GET request to the endpoint ''/z/00001012053500''[^If [[authentication is enabled|00001010040100]], you must include the a valid [[access token|00001012050200]] in the ''Authorization'' header] with the query parameter ''enc=sz''.\nIf successful, the output is a symbolic expression value:\n```sh\n# curl 'http://127.0.0.1:23123/z/00001012053500?enc=sz'\n(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 \") ...\n```\n\nTo select another encoding, you must provide the query parameter ''enc=ENCODING''.\nOthers are \"\"[[html|00001012920510]]\"\", \"\"[[text|00001012920519]]\"\", and some [[more|00001012920500]].\nIn addition, you may provide a query parameter ''part=PART'' to select the relevant [[part|00001012920800]] of a zettel.\n```sh\n# curl 'http://127.0.0.1:23123/z/00001012053500?enc=html&part=zettel'\n\n\n\nAPI: Retrieve evaluated metadata and content of an existing zettel in various encodings\n\n\n\n\n\n\n\n\">\n\n\n\n\n\n\n\n\n\nAPI: Retrieve evaluated metadata and content of an existing zettel in various encodings
\nThe endpoint to work with evaluated metadata and content of a specific zettel is /z/{ID},\n...\n```\n\n=== HTTP Status codes\n; ''200''\n: Retrieval was successful, the body contains an appropriate data value.\n; ''400''\n: Request was not valid. \n There are several reasons for this.\n Maybe the zettel identifier did not consist of exactly 14 digits or ''enc'' / ''part'' contained illegal values.\n; ''403''\n: You are not allowed to retrieve data of the given zettel.\n; ''404''\n: Zettel not found.\n You probably used a zettel identifier that is not used in the Zettelstore."))