((META (EMPTY-STRING title "API: Determine a role zettel") (WORD role "manual") (TAG-SET tags ("#api" "#manual" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001005090000" "00001012000000")) (ZID-SET backward ("00001005090000" "00001012000000")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20231128183917") (ZID-SET forward ("00001006020100" "00001012920000")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20231128184701") (TIMESTAMP published "20231128184701") (WORD visibility "public")) (BLOCK (PARA (TEXT "The") (SPACE) (LINK-ZETTEL () "00001012920000" (TEXT "endpoint")) (SPACE) (LITERAL-INPUT () "/z") (SPACE) (TEXT "also") (SPACE) (TEXT "allows") (SPACE) (TEXT "you") (SPACE) (TEXT "to") (SPACE) (TEXT "determine") (SPACE) (TEXT "a") (SPACE) (FORMAT-QUOTE () (TEXT "role") (SPACE) (TEXT "zettel")) (TEXT ",") (SPACE) (TEXT "i.e.") (SPACE) (TEXT "a") (SPACE) (TEXT "zettel") (SPACE) (TEXT "that") (SPACE) (TEXT "documents") (SPACE) (TEXT "a") (SPACE) (TEXT "given") (SPACE) (TEXT "role.")) (PARA (TEXT "The") (SPACE) (TEXT "query") (SPACE) (TEXT "parameter") (SPACE) (FORMAT-QUOTE () (LITERAL-INPUT () "role")) (SPACE) (TEXT "allows") (SPACE) (TEXT "you") (SPACE) (TEXT "to") (SPACE) (TEXT "specify") (SPACE) (TEXT "a") (SPACE) (TEXT "value") (SPACE) (TEXT "that") (SPACE) (TEXT "is") (SPACE) (TEXT "interpreted") (SPACE) (TEXT "as") (SPACE) (TEXT "the") (SPACE) (TEXT "name") (SPACE) (TEXT "of") (SPACE) (TEXT "a") (SPACE) (TEXT "role.") (SOFT) (TEXT "Zettelstore") (SPACE) (TEXT "tries") (SPACE) (TEXT "to") (SPACE) (TEXT "determine") (SPACE) (TEXT "the") (SPACE) (TEXT "corresponding") (SPACE) (TEXT "role") (SPACE) (TEXT "zettel.")) (PARA (TEXT "A") (SPACE) (TEXT "role") (SPACE) (TEXT "zettel") (SPACE) (TEXT "is") (SPACE) (TEXT "a") (SPACE) (TEXT "zettel") (SPACE) (TEXT "with") (SPACE) (TEXT "the") (SPACE) (LINK-ZETTEL () "00001006020100" (LITERAL-INPUT () "role")) (SPACE) (TEXT "value") (SPACE) (FORMAT-QUOTE () (TEXT "role")) (SPACE) (TEXT "and") (SPACE) (TEXT "a") (SPACE) (TEXT "title") (SPACE) (TEXT "that") (SPACE) (TEXT "names") (SPACE) (TEXT "the") (SPACE) (TEXT "role.") (SOFT) (TEXT "If") (SPACE) (TEXT "there") (SPACE) (TEXT "is") (SPACE) (TEXT "more") (SPACE) (TEXT "than") (SPACE) (TEXT "one") (SPACE) (TEXT "zettel") (SPACE) (TEXT "that") (SPACE) (TEXT "qualifies,") (SPACE) (TEXT "the") (SPACE) (TEXT "zettel") (SPACE) (TEXT "with") (SPACE) (TEXT "the") (SPACE) (TEXT "highest") (SPACE) (TEXT "zettel") (SPACE) (TEXT "identifier") (SPACE) (TEXT "is") (SPACE) (TEXT "used.")) (PARA (TEXT "For") (SPACE) (TEXT "example,") (SPACE) (TEXT "if") (SPACE) (TEXT "you") (SPACE) (TEXT "want") (SPACE) (TEXT "to") (SPACE) (TEXT "determine") (SPACE) (TEXT "the") (SPACE) (TEXT "role") (SPACE) (TEXT "zettel") (SPACE) (TEXT "for") (SPACE) (TEXT "the") (SPACE) (TEXT "role") (SPACE) (FORMAT-QUOTE () (TEXT "manual")) (TEXT ",") (SPACE) (TEXT "your") (SPACE) (TEXT "request") (SPACE) (TEXT "will") (SPACE) (TEXT "be:")) (VERBATIM-CODE (("" . "sh")) "# curl -i 'http://127.0.0.1:23123/z?role=manual'\nHTTP/1.1 302 Found\nContent-Type: text/plain; charset=utf-8\nLocation: /z/20231128184200\nContent-Length: 14\n\n20231128184200") (PARA (TEXT "If") (SPACE) (TEXT "there") (SPACE) (TEXT "is") (SPACE) (TEXT "a") (SPACE) (TEXT "corresponding") (SPACE) (TEXT "role") (SPACE) (TEXT "zettel,") (SPACE) (TEXT "the") (SPACE) (TEXT "response") (SPACE) (TEXT "will") (SPACE) (TEXT "use") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "status") (SPACE) (TEXT "code") (SPACE) (TEXT "302") (SPACE) (TEXT "(") (FORMAT-QUOTE () (TEXT "Found")) (TEXT "),") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "response") (SPACE) (TEXT "header") (SPACE) (LITERAL-INPUT () "Location") (SPACE) (TEXT "will") (SPACE) (TEXT "contain") (SPACE) (TEXT "the") (SPACE) (TEXT "URL") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "role") (SPACE) (TEXT "zettel.") (SOFT) (TEXT "Its") (SPACE) (TEXT "zettel") (SPACE) (TEXT "identifier") (SPACE) (TEXT "will") (SPACE) (TEXT "be") (SPACE) (TEXT "returned") (SPACE) (TEXT "in") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "response") (SPACE) (TEXT "body.")) (PARA (TEXT "If") (SPACE) (TEXT "you") (SPACE) (TEXT "specified") (SPACE) (TEXT "some") (SPACE) (TEXT "more") (SPACE) (TEXT "query") (SPACE) (TEXT "parameter,") (SPACE) (TEXT "these") (SPACE) (TEXT "will") (SPACE) (TEXT "be") (SPACE) (TEXT "part") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "URL") (SPACE) (TEXT "in") (SPACE) (TEXT "the") (SPACE) (TEXT "response") (SPACE) (TEXT "header") (SPACE) (LITERAL-INPUT () "Location") (TEXT ":")) (VERBATIM-CODE (("" . "sh")) "# curl -i 'http://127.0.0.1:23123/z?role=manual&part=zettel'\nHTTP/1.1 302 Found\nContent-Type: text/plain; charset=utf-8\nLocation: /z/20231128184200?part=zettel\nContent-Length: 14\n\n20231128184200") (PARA (TEXT "Otherwise,") (SPACE) (TEXT "if") (SPACE) (TEXT "no") (SPACE) (TEXT "role") (SPACE) (TEXT "zettel") (SPACE) (TEXT "was") (SPACE) (TEXT "found,") (SPACE) (TEXT "the") (SPACE) (TEXT "response") (SPACE) (TEXT "will") (SPACE) (TEXT "use") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "status") (SPACE) (TEXT "code") (SPACE) (TEXT "404") (SPACE) (TEXT "(") (FORMAT-QUOTE () (TEXT "Not") (SPACE) (TEXT "found")) (TEXT ").")) (VERBATIM-CODE (("" . "sh")) "# curl -i 'http://127.0.0.1:23123/z?role=norole'\nHTTP/1.1 404 Not Found\nContent-Type: text/plain; charset=utf-8\nContent-Length: 30\n\nRole zettel not found: norole") (PARA (TEXT "To") (SPACE) (TEXT "fulfill") (SPACE) (TEXT "this") (SPACE) (TEXT "service,") (SPACE) (TEXT "Zettelstore") (SPACE) (TEXT "will") (SPACE) (TEXT "evaluate") (SPACE) (TEXT "internally") (SPACE) (TEXT "the") (SPACE) (TEXT "query") (SPACE) (LITERAL-INPUT () "role:role title=ROLE") (TEXT ",") (SPACE) (TEXT "there") (SPACE) (LITERAL-INPUT () "ROLE") (SPACE) (TEXT "is") (SPACE) (TEXT "the") (SPACE) (TEXT "actual") (SPACE) (TEXT "role.")) (PARA (TEXT "Of") (SPACE) (TEXT "course,") (SPACE) (TEXT "if") (SPACE) (TEXT "you") (SPACE) (TEXT "are") (SPACE) (TEXT "only") (SPACE) (TEXT "interested") (SPACE) (TEXT "in") (SPACE) (TEXT "the") (SPACE) (TEXT "URL") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "role") (SPACE) (TEXT "zettel,") (SPACE) (TEXT "you") (SPACE) (TEXT "can") (SPACE) (TEXT "make") (SPACE) (TEXT "use") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (LITERAL-INPUT () "HEAD") (SPACE) (TEXT "method:")) (VERBATIM-CODE (("" . "sh")) "# curl -I 'http://127.0.0.1:23123/z?role=manual'\nHTTP/1.1 302 Found\nContent-Type: text/plain; charset=utf-8\nLocation: /z/20231128184200\nContent-Length: 14") (HEADING 1 () "http-status-codes" "http-status-codes" (TEXT "HTTP") (SPACE) (TEXT "Status") (SPACE) (TEXT "codes")) (DESCRIPTION ((LITERAL-INPUT () "302")) (BLOCK (BLOCK (PARA (TEXT "Role") (SPACE) (TEXT "zettel") (SPACE) (TEXT "was") (SPACE) (TEXT "found.") (SOFT) (TEXT "The") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "header") (SPACE) (LITERAL-INPUT () "Location") (SPACE) (TEXT "contains") (SPACE) (TEXT "its") (SPACE) (TEXT "URL,") (SPACE) (TEXT "the") (SPACE) (TEXT "body") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "response") (SPACE) (TEXT "contains") (SPACE) (TEXT "its") (SPACE) (TEXT "zettel") (SPACE) (TEXT "identifier.")))) ((LITERAL-INPUT () "404")) (BLOCK (BLOCK (PARA (TEXT "No") (SPACE) (TEXT "zettel") (SPACE) (TEXT "for") (SPACE) (TEXT "the") (SPACE) (TEXT "given") (SPACE) (TEXT "role") (SPACE) (TEXT "was") (SPACE) (TEXT "found.")))))))