(((meta (@ (content . "API: Provide an access token") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#api #manual #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001012000000 00001012080500") (name . "back"))) (meta (@ (content . "00001012000000 00001012080500") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "00010101000000") (name . "created"))) (meta (@ (content . "00001012050200 00001012921000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20220218130020") (name . "modified"))) (meta (@ (content . "20220218130020") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "The" " " (a (@ (href . "00001012050200")) "authentication" " " "process") " " "provides" " " "you" " " "with" " " "an" " " (a (@ (href . "00001012921000")) "access" " " "token") "." " " "Most" " " "API" " " "calls" " " "need" " " "such" " " "an" " " "access" " " "token," " " "so" " " "that" " " "they" " " "know" " " "the" " " "identity" " " "of" " " "the" " " "caller.") (p "You" " " "send" " " "the" " " "access" " " "token" " " "in" " " "the" " " (@L (@H "&ldquo;") "Authorization" (@H "&rdquo;")) " " "request" " " "header" " " "field," " " "as" " " "described" " " "in" " " (a (@ (class . "external") (href . "https://tools.ietf.org/html/rfc6750#section-2.1")) "RFC" " " "6750," " " "section" " " "2.1") "." " " "You" " " "need" " " "to" " " "use" " " "the" " " (@L (@H "&ldquo;") "Bearer" (@H "&rdquo;")) " " "authentication" " " "scheme" " " "to" " " "transmit" " " "the" " " "access" " " "token.") (p "For" " " "example" " " "(in" " " "plain" " " "text" " " "HTTP):") (pre (code "GET /z HTTP/1.0\nAuthorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJfdGsiOjEsImV4cCI6MTYwMTczMTI3NSwiaWF0IjoxNjAxNzMwNjc1LCJzdWIiOiJhYmMiLCJ6aWQiOiIyMDIwMTAwMzE1MDEwMCJ9.ekhXkvn146P2bMKFQcU-bNlvgbeO6sS39hs6U5EKfjIqnSInkuHYjYAIfUqf_clYRfr6YBlX5izii8XfxV8jhg")) (p "Note," " " "that" " " "there" " " "is" " " "exactly" " " "one" " " "space" " " "character" " " "(" (@L (@H "&ldquo;") (kbd "␣") (@H "&rdquo;")) "," " " "U+0020)" " " "between" " " "the" " " "string" " " (@L (@H "&ldquo;") "Bearer" (@H "&rdquo;")) " " "and" " " "the" " " "access" " " "token:" " " (code "Authorization:␣Bearer␣eyJhbGciOiJIUzUxMiJ9.ey...") ".") (p "If" " " "you" " " "use" " " "the" " " (a (@ (class . "external") (href . "https://curl.haxx.se/")) "curl") " " "tool," " " "you" " " "can" " " "use" " " "the" " " (kbd "-H") " " "command" " " "line" " " "parameter" " " "to" " " "set" " " "this" " " "header" " " "field."))