(((meta (@ (content . "API: Retrieve metadata of an existing zettel") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#api #manual #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001012000000 00001012053300") (name . "back"))) (meta (@ (content . "00001012000000 00001012053300") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20210726174524") (name . "created"))) (meta (@ (content . "00001006050000 00001010040100 00001012050200 00001012920000 00001012921200 00001012930500") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20230807170155") (name . "modified"))) (meta (@ (content . "20230807170155") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "The" " " (a (@ (href . "00001012920000")) "endpoint") " " "to" " " "work" " " "with" " " "metadata" " " "of" " " "a" " " "specific" " " "zettel" " " "is" " " (kbd "/z/{ID}") "," " " "where" " " (kbd "{ID}") " " "is" " " "a" " " "placeholder" " " "for" " " "the" " " (a (@ (href . "00001006050000")) "zettel" " " "identifier") (sup (@ (id . "fnref:1")) (a (@ (class . "zs-noteref") (href . "#fn:1") (role . "doc-noteref")) "1")) ".") (p "To" " " "retrieve" " " "the" " " "plain" " " "metadata" " " "of" " " "a" " " "zettel," " " "use" " " "the" " " "query" " " "parameter" " " (kbd "part=meta")) (pre (code (@ (class . "language-sh")) "# curl 'http://127.0.0.1:23123/z/00001012053400?part=meta'\ntitle: API: Retrieve metadata of an existing zettel\nrole: manual\ntags: #api #manual #zettelstore\nsyntax: zmk")) (h2 (@ (id . "data-output")) "Data" " " "output") (p "Alternatively," " " "you" " " "may" " " "retrieve" " " "the" " " "zettel" " " "as" " " "a" " " "parseable" " " "object" " " "/" " " "a" " " (a (@ (href . "00001012930500")) "symbolic" " " "expression") " " "by" " " "providing" " " "the" " " "query" " " "parameter" " " (kbd "enc=data") ":") (pre (code (@ (class . "language-sh")) "# curl 'http://127.0.0.1:23123/z/00001012053400?part=meta&enc=data'\n(list (meta (title \"API: Retrieve metadata of an existing zettel\") (role \"manual\") (tags \"#api #manual #zettelstore\") (syntax \"zmk\") (back \"00001012000000 00001012053300\") (backward \"00001012000000 00001012053300\") (box-number \"1\") (created \"20210726174524\") (forward \"00001006020000 00001006050000 00001010040100 00001012050200 00001012920000 00001012921200\") (modified \"20230703174515\") (published \"20230703174515\")) (rights 62))")) (p "Pretty-printed," " " "this" " " "results" " " "in:") (pre (code "(list (meta (title \"API: Retrieve metadata of an existing zettel\")\n            (role \"manual\")\n            (tags \"#api #manual #zettelstore\")\n            (syntax \"zmk\")\n            (back \"00001012000000 00001012053300\")\n            (backward \"00001012000000 00001012053300\")\n            (box-number \"1\")\n            (created \"20210726174524\")\n            (forward \"00001006020000 00001006050000 00001010040100 00001012050200 00001012920000 00001012921200\")\n            (modified \"20230703174515\")\n            (published \"20230703174515\"))\n      (rights 62))")) (ul (li "The" " " "result" " " "is" " " "a" " " "list," " " "starting" " " "with" " " "the" " " "symbol" " " (kbd "list") ".") (li "Then," " " "some" " " "key/value" " " "pairs" " " "are" " " "following," " " "also" " " "nested.") (li "Nested" " " "in" " " (kbd "meta") " " "are" " " "the" " " "metadata," " " "each" " " "as" " " "a" " " "key/value" " " "pair.") (li (kbd "rights") " " "specifies" " " "the" " " (a (@ (href . "00001012921200")) "access" " " "rights") " " "the" " " "user" " " "has" " " "for" " " "this" " " "zettel.")) (h2 (@ (id . "http-status-codes")) "HTTP" " " "Status" " " "codes") (dl (dt (kbd "200")) (dd (p "Retrieval" " " "was" " " "successful," " " "the" " " "body" " " "contains" " " "an" " " "appropriate" " " "data" " " "value.")) (dt (kbd "400")) (dd (p "Request" " " "was" " " "not" " " "valid." " " " " "There" " " "are" " " "several" " " "reasons" " " "for" " " "this." " " "Maybe" " " "the" " " "zettel" " " "identifier" " " "did" " " "not" " " "consist" " " "of" " " "exactly" " " "14" " " "digits.")) (dt (kbd "403")) (dd (p "You" " " "are" " " "not" " " "allowed" " " "to" " " "retrieve" " " "data" " " "of" " " "the" " " "given" " " "zettel.")) (dt (kbd "404")) (dd (p "Zettel" " " "not" " " "found." " " "You" " " "probably" " " "used" " " "a" " " "zettel" " " "identifier" " " "that" " " "is" " " "not" " " "used" " " "in" " " "the" " " "Zettelstore."))))