(BLOCK (PARA (TEXT "Authentication") (SPACE) (TEXT "for") (SPACE) (TEXT "future") (SPACE) (TEXT "API") (SPACE) (TEXT "calls") (SPACE) (TEXT "is") (SPACE) (TEXT "done") (SPACE) (TEXT "by") (SPACE) (TEXT "sending") (SPACE) (TEXT "a") (SPACE) (LINK-ZETTEL () "00001010040200" (TEXT "user") (SPACE) (TEXT "identification")) (SPACE) (TEXT "and") (SPACE) (TEXT "a") (SPACE) (TEXT "password") (SPACE) (TEXT "to") (SPACE) (TEXT "the") (SPACE) (TEXT "Zettelstore") (SPACE) (TEXT "to") (SPACE) (TEXT "obtain") (SPACE) (TEXT "an") (SPACE) (LINK-ZETTEL () "00001010040700" (TEXT "access") (SPACE) (TEXT "token")) (TEXT ".") (SOFT) (TEXT "This") (SPACE) (TEXT "token") (SPACE) (TEXT "has") (SPACE) (TEXT "to") (SPACE) (TEXT "be") (SPACE) (TEXT "used") (SPACE) (TEXT "for") (SPACE) (TEXT "other") (SPACE) (TEXT "API") (SPACE) (TEXT "calls.") (SOFT) (TEXT "It") (SPACE) (TEXT "is") (SPACE) (TEXT "valid") (SPACE) (TEXT "for") (SPACE) (TEXT "a") (SPACE) (TEXT "relatively") (SPACE) (TEXT "short") (SPACE) (TEXT "amount") (SPACE) (TEXT "of") (SPACE) (TEXT "time,") (SPACE) (TEXT "as") (SPACE) (TEXT "configured") (SPACE) (TEXT "with") (SPACE) (TEXT "the") (SPACE) (TEXT "key") (SPACE) (LITERAL-INPUT () "token-lifetime-api") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (LINK-ZETTEL () "00001004010000#token-lifetime-api" (TEXT "startup") (SPACE) (TEXT "configuration")) (SPACE) (TEXT "(typically") (SPACE) (TEXT "10") (SPACE) (TEXT "minutes).")) (PARA (TEXT "The") (SPACE) (TEXT "simplest") (SPACE) (TEXT "way") (SPACE) (TEXT "is") (SPACE) (TEXT "to") (SPACE) (TEXT "send") (SPACE) (TEXT "user") (SPACE) (TEXT "identification") (SPACE) (TEXT "(") (LITERAL-INPUT () "IDENT") (TEXT ")") (SPACE) (TEXT "and") (SPACE) (TEXT "password") (SPACE) (TEXT "(") (LITERAL-INPUT () "PASSWORD") (TEXT ")") (SPACE) (TEXT "via") (SPACE) (LINK-EXTERNAL () "https://tools.ietf.org/html/rfc7617" (TEXT "HTTP") (SPACE) (TEXT "Basic") (SPACE) (TEXT "Authentication")) (SPACE) (TEXT "and") (SPACE) (TEXT "send") (SPACE) (TEXT "them") (SPACE) (TEXT "to") (SPACE) (TEXT "the") (SPACE) (LINK-ZETTEL () "00001012920000" (TEXT "endpoint")) (SPACE) (LITERAL-INPUT () "/a") (SPACE) (TEXT "with") (SPACE) (TEXT "a") (SPACE) (TEXT "POST") (SPACE) (TEXT "request:")) (VERBATIM-CODE (("" . "sh")) "# curl -X POST -u IDENT:PASSWORD http://127.0.0.1:23123/a\n(\"Bearer\" \"eyJhbGciOiJIUzUxMiJ9.eyJfdGsiOjEsImV4cCI6MTY4MTMwNDA2MiwiaWF0IjoxNjgxMzA0MDAyLCJzdWIiOiJvd25lciIsInppZCI6IjIwMjEwNjI5MTYzMzAwIn0.kdF8PdiL50gIPkRD3ovgR6nUXR0-80EKAXcY2zVYgYvryF09iXnNR3zrvYnGzdrArMcnvAYqVvuXtqhQj2jG9g\" 600)") (PARA (TEXT "Some") (SPACE) (TEXT "tools,") (SPACE) (TEXT "like") (SPACE) (LINK-EXTERNAL () "https://curl.haxx.se/" (TEXT "curl")) (TEXT ",") (SPACE) (TEXT "also") (SPACE) (TEXT "allow") (SPACE) (TEXT "to") (SPACE) (TEXT "specify") (SPACE) (TEXT "user") (SPACE) (TEXT "identification") (SPACE) (TEXT "and") (SPACE) (TEXT "password") (SPACE) (TEXT "as") (SPACE) (TEXT "part") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "URL:")) (VERBATIM-CODE (("" . "sh")) "# curl -X POST http://IDENT:PASSWORD@127.0.0.1:23123/a\n(\"Bearer\" \"eyJhbGciOiJIUzUxMiJ9.eyJfdGsiOjEsImV4cCI6MTY4MTMwNDA4NiwiaWF0IjoxNjgxMzA0MDI2LCJzdWIiOiJvd25lciIsInppZCI6IjIwMjEwNjI5MTYzMzAwIn0.kZd3prYc79dt9efDsrYVHtKrjWyOWvfByjeeUB3hf_vs43V3SNJqmb8k-zTHVNWOK0-5orVPrg2tIAqbXqmkhg\" 600)") (PARA (TEXT "If") (SPACE) (TEXT "you") (SPACE) (TEXT "do") (SPACE) (TEXT "not") (SPACE) (TEXT "want") (SPACE) (TEXT "to") (SPACE) (TEXT "use") (SPACE) (TEXT "Basic") (SPACE) (TEXT "Authentication,") (SPACE) (TEXT "you") (SPACE) (TEXT "can") (SPACE) (TEXT "also") (SPACE) (TEXT "send") (SPACE) (TEXT "user") (SPACE) (TEXT "identification") (SPACE) (TEXT "and") (SPACE) (TEXT "password") (SPACE) (TEXT "as") (SPACE) (TEXT "HTML") (SPACE) (TEXT "form") (SPACE) (TEXT "data:")) (VERBATIM-CODE (("" . "sh")) "# curl -X POST -d 'username=IDENT&password=PASSWORD' http://127.0.0.1:23123/a\n(\"Bearer\" \"eyJhbGciOiJIUzUxMiJ9.eyJfdGsiOjEsImV4cCI6MTY4MTMwNDA4OCwiaWF0IjoxNjgxMzA0MDI4LCJzdWIiOiJvd25lciIsInppZCI6IjIwMjEwNjI5MTYzMzAwIn0.qIEyOMFXykCApWtBaqbSESwTL96stWl2LRICiRNAXUjcY-mwx_SSl9L5Fj2FvmrI1K1RBvWehjoq8KZUNjhJ9Q\" 600)") (PARA (TEXT "In") (SPACE) (TEXT "all") (SPACE) (TEXT "cases,") (SPACE) (TEXT "you") (SPACE) (TEXT "will") (SPACE) (TEXT "receive") (SPACE) (TEXT "a") (SPACE) (TEXT "list") (SPACE) (TEXT "with") (SPACE) (TEXT "three") (SPACE) (TEXT "elements") (SPACE) (TEXT "that") (SPACE) (TEXT "will") (SPACE) (TEXT "contain") (SPACE) (TEXT "all") (SPACE) (LINK-ZETTEL () "00001012921000" (TEXT "relevant") (SPACE) (TEXT "data")) (SPACE) (TEXT "to") (SPACE) (TEXT "be") (SPACE) (TEXT "used") (SPACE) (TEXT "for") (SPACE) (TEXT "further") (SPACE) (TEXT "API") (SPACE) (TEXT "calls.")) (PARA (FORMAT-STRONG () (TEXT "Important:")) (SPACE) (TEXT "obtaining") (SPACE) (TEXT "a") (SPACE) (TEXT "token") (SPACE) (TEXT "is") (SPACE) (TEXT "a") (SPACE) (TEXT "time-intensive") (SPACE) (TEXT "process.") (SOFT) (TEXT "Zettelstore") (SPACE) (TEXT "will") (SPACE) (TEXT "delay") (SPACE) (TEXT "every") (SPACE) (TEXT "request") (SPACE) (TEXT "to") (SPACE) (TEXT "obtain") (SPACE) (TEXT "a") (SPACE) (TEXT "token") (SPACE) (TEXT "for") (SPACE) (TEXT "a") (SPACE) (TEXT "certain") (SPACE) (TEXT "amount") (SPACE) (TEXT "of") (SPACE) (TEXT "time.") (SOFT) (TEXT "Please") (SPACE) (TEXT "take") (SPACE) (TEXT "into") (SPACE) (TEXT "account") (SPACE) (TEXT "that") (SPACE) (TEXT "this") (SPACE) (TEXT "request") (SPACE) (TEXT "will") (SPACE) (TEXT "take") (SPACE) (TEXT "approximately") (SPACE) (TEXT "500") (SPACE) (TEXT "milliseconds,") (SPACE) (TEXT "under") (SPACE) (TEXT "certain") (SPACE) (TEXT "circumstances") (SPACE) (TEXT "more.")) (PARA (TEXT "However,") (SPACE) (TEXT "if") (SPACE) (LINK-ZETTEL () "00001010040100" (TEXT "authentication") (SPACE) (TEXT "is") (SPACE) (TEXT "not") (SPACE) (TEXT "enabled")) (SPACE) (TEXT "and") (SPACE) (TEXT "you") (SPACE) (TEXT "send") (SPACE) (TEXT "an") (SPACE) (TEXT "authentication") (SPACE) (TEXT "request,") (SPACE) (TEXT "no") (SPACE) (TEXT "user") (SPACE) (TEXT "identification/password") (SPACE) (TEXT "checking") (SPACE) (TEXT "is") (SPACE) (TEXT "done") (SPACE) (TEXT "and") (SPACE) (TEXT "you") (SPACE) (TEXT "receive") (SPACE) (TEXT "an") (SPACE) (TEXT "artificial") (SPACE) (TEXT "token") (SPACE) (TEXT "immediate,") (SPACE) (TEXT "without") (SPACE) (TEXT "any") (SPACE) (TEXT "delay:")) (VERBATIM-CODE (("" . "sh")) "# curl -X POST -u IDENT:PASSWORD http://127.0.0.1:23123/a\n(\"Bearer\" \"freeaccess\" 316224000)") (PARA (TEXT "In") (SPACE) (TEXT "this") (SPACE) (TEXT "case,") (SPACE) (TEXT "it") (SPACE) (TEXT "is") (SPACE) (TEXT "even") (SPACE) (TEXT "possible") (SPACE) (TEXT "to") (SPACE) (TEXT "omit") (SPACE) (TEXT "the") (SPACE) (TEXT "user") (SPACE) (TEXT "identification/password.")) (HEADING 1 () "http-status-codes" "http-status-codes" (TEXT "HTTP") (SPACE) (TEXT "Status") (SPACE) (TEXT "codes")) (PARA (TEXT "In") (SPACE) (TEXT "all") (SPACE) (TEXT "cases") (SPACE) (TEXT "of") (SPACE) (TEXT "successful") (SPACE) (TEXT "authentication,") (SPACE) (TEXT "a") (SPACE) (TEXT "list") (SPACE) (TEXT "is") (SPACE) (TEXT "returned,") (SPACE) (TEXT "which") (SPACE) (TEXT "contains") (SPACE) (TEXT "the") (SPACE) (TEXT "token") (SPACE) (TEXT "as") (SPACE) (TEXT "the") (SPACE) (TEXT "second") (SPACE) (TEXT "element.") (SOFT) (TEXT "A") (SPACE) (TEXT "successful") (SPACE) (TEXT "authentication") (SPACE) (TEXT "is") (SPACE) (TEXT "signaled") (SPACE) (TEXT "with") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "status") (SPACE) (TEXT "code") (SPACE) (TEXT "200,") (SPACE) (TEXT "as") (SPACE) (TEXT "usual.")) (PARA (TEXT "Other") (SPACE) (TEXT "status") (SPACE) (TEXT "codes") (SPACE) (TEXT "possibly") (SPACE) (TEXT "send") (SPACE) (TEXT "by") (SPACE) (TEXT "the") (SPACE) (TEXT "Zettelstore:")) (DESCRIPTION ((LITERAL-INPUT () "400")) (BLOCK (BLOCK (PARA (TEXT "Unable") (SPACE) (TEXT "to") (SPACE) (TEXT "process") (SPACE) (TEXT "the") (SPACE) (TEXT "request.") (SOFT) (TEXT "In") (SPACE) (TEXT "most") (SPACE) (TEXT "cases") (SPACE) (TEXT "the") (SPACE) (TEXT "form") (SPACE) (TEXT "data") (SPACE) (TEXT "was") (SPACE) (TEXT "invalid.")))) ((LITERAL-INPUT () "401")) (BLOCK (BLOCK (PARA (TEXT "Authentication") (SPACE) (TEXT "failed.") (SOFT) (TEXT "Either") (SPACE) (TEXT "the") (SPACE) (TEXT "user") (SPACE) (TEXT "identification") (SPACE) (TEXT "is") (SPACE) (TEXT "invalid") (SPACE) (TEXT "or") (SPACE) (TEXT "you") (SPACE) (TEXT "provided") (SPACE) (TEXT "the") (SPACE) (TEXT "wrong") (SPACE) (TEXT "password.")))) ((LITERAL-INPUT () "403")) (BLOCK (BLOCK (PARA (TEXT "Authentication") (SPACE) (TEXT "is") (SPACE) (TEXT "not") (SPACE) (TEXT "active."))))))