[{"data":1,"prerenderedAt":253},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-authentication":55,"-getting-started-authentication-surround":248},[4,30],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting Started","\u002Fgetting-started","1.getting-started",[9,13,17,21,25],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Authentication","\u002Fgetting-started\u002Fauthentication","1.getting-started\u002F2.authentication",{"title":18,"path":19,"stem":20},"Concepts","\u002Fgetting-started\u002Fconcepts","1.getting-started\u002F3.concepts",{"title":22,"path":23,"stem":24},"Order keys","\u002Fgetting-started\u002Forder-keys","1.getting-started\u002F4.order-keys",{"title":26,"path":27,"stem":28},"Errors and retries","\u002Fgetting-started\u002Ferrors-and-retries","1.getting-started\u002F5.errors-and-retries",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"API","\u002Fapi","2.api",[35,39,43,47,51],{"title":36,"path":37,"stem":38},"Create order","\u002Fapi\u002Fcreate-order","2.api\u002F1.create-order",{"title":40,"path":41,"stem":42},"Fetch printers","\u002Fapi\u002Ffetch-printers","2.api\u002F2.fetch-printers",{"title":44,"path":45,"stem":46},"Print orders","\u002Fapi\u002Fprint-orders","2.api\u002F3.print-orders",{"title":48,"path":49,"stem":50},"Fetch order PDF","\u002Fapi\u002Ffetch-order-pdf","2.api\u002F4.fetch-order-pdf",{"title":52,"path":53,"stem":54},"Links","\u002Fapi\u002Flinks","2.api\u002F5.links",{"id":56,"title":14,"body":57,"description":241,"extension":242,"links":243,"meta":244,"navigation":245,"path":15,"seo":246,"stem":16,"__hash__":247},"docs\u002F1.getting-started\u002F2.authentication.md",{"type":58,"value":59,"toc":235},"minimark",[60,64,73,78,109,112,116,119,135,177,181,184,187,191,231],[61,62,14],"h1",{"id":63},"authentication",[65,66,67,68,72],"p",{},"The Yuzu API uses the ",[69,70,71],"code",{},"X-API-Key"," header for authentication.",[74,75,77],"h2",{"id":76},"create-an-api-key","Create an API key",[79,80,81,93,100,106],"ol",{},[82,83,84,85,92],"li",{},"Open ",[86,87,91],"a",{"href":88,"rel":89},"https:\u002F\u002Fapp.yuzu.so\u002Fsettings\u002Fapi-keys",[90],"nofollow","Settings > API Keys",".",[82,94,95,96,92],{},"Click ",[97,98,99],"strong",{},"Create API Key",[82,101,102,103,92],{},"Give the key a clear name, such as ",[69,104,105],{},"warehouse-sync-production",[82,107,108],{},"Copy the secret before closing the confirmation screen.",[65,110,111],{},"Yuzu only shows the full key once. If the secret is lost, revoke it and create a new key.",[74,113,115],{"id":114},"send-the-key","Send the key",[65,117,118],{},"Include the key with every API request:",[120,121,126],"pre",{"className":122,"code":123,"language":124,"meta":125,"style":125},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","X-API-Key: YOUR_API_KEY\n","http","",[69,127,128],{"__ignoreMap":125},[129,130,133],"span",{"class":131,"line":132},"line",1,[129,134,123],{},[120,136,140],{"className":137,"code":138,"language":139,"meta":125,"style":125},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl 'https:\u002F\u002Fapp.yuzu.so\u002Fapi\u002Forders' \\\n  --header 'X-API-Key: YOUR_API_KEY'\n","bash",[69,141,142,163],{"__ignoreMap":125},[129,143,144,148,152,156,159],{"class":131,"line":132},[129,145,147],{"class":146},"sBMFI","curl",[129,149,151],{"class":150},"sMK4o"," '",[129,153,155],{"class":154},"sfazB","https:\u002F\u002Fapp.yuzu.so\u002Fapi\u002Forders",[129,157,158],{"class":150},"'",[129,160,162],{"class":161},"sTEyZ"," \\\n",[129,164,166,169,171,174],{"class":131,"line":165},2,[129,167,168],{"class":154},"  --header",[129,170,151],{"class":150},[129,172,173],{"class":154},"X-API-Key: YOUR_API_KEY",[129,175,176],{"class":150},"'\n",[74,178,180],{"id":179},"handling-keys","Handling keys",[65,182,183],{},"Store API keys in your server-side secret manager. Do not expose them in browser code, mobile apps, public repos, logs, or support screenshots.",[65,185,186],{},"Use separate keys for development and production so you can rotate one environment without breaking the other.",[74,188,190],{"id":189},"common-auth-errors","Common auth errors",[192,193,194,207],"table",{},[195,196,197],"thead",{},[198,199,200,204],"tr",{},[201,202,203],"th",{},"Status",[201,205,206],{},"Meaning",[208,209,210,221],"tbody",{},[198,211,212,218],{},[213,214,215],"td",{},[69,216,217],{},"401",[213,219,220],{},"Missing, malformed, revoked, or invalid API key.",[198,222,223,228],{},[213,224,225],{},[69,226,227],{},"403",[213,229,230],{},"The key is valid but cannot access the requested team resource.",[232,233,234],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":125,"searchDepth":165,"depth":165,"links":236},[237,238,239,240],{"id":76,"depth":165,"text":77},{"id":114,"depth":165,"text":115},{"id":179,"depth":165,"text":180},{"id":189,"depth":165,"text":190},"Authenticate Yuzu API requests with X-API-Key.","md",null,{},true,{"title":14,"description":241},"REPCd6BKUW8FO93nvtcgZRQkVHSy8vCyhya5PycW-aA",[249,251],{"title":10,"path":11,"stem":12,"description":250,"children":-1},"Learn what the Yuzu API is for.",{"title":18,"path":19,"stem":20,"description":252,"children":-1},"Core resources used by the Yuzu API.",1780070562370]