[{"data":1,"prerenderedAt":213},["ShallowReactive",2],{"docs:\u002Fdocs\u002Fauthentication":3,"docs:nav":199},{"id":4,"title":5,"body":6,"description":191,"extension":192,"meta":193,"navigation":194,"order":99,"path":195,"seo":196,"stem":197,"__hash__":198},"docs\u002Fdocs\u002Fauthentication.md","Authentifizierung",{"type":7,"value":8,"toc":185},"minimark",[9,13,22,27,52,60,64,71,113,120,144,148,159,167,171,181],[10,11,5],"h1",{"id":12},"authentifizierung",[14,15,16,17,21],"p",{},"Alle API-Anfragen werden mit einem persönlichen ",[18,19,20],"strong",{},"API-Schlüssel","\nauthentifiziert. Es gibt keine gesonderten OAuth-Flows – ein Schlüssel genügt.",[23,24,26],"h2",{"id":25},"schlüssel-erstellen","Schlüssel erstellen",[28,29,30,39,45],"ol",{},[31,32,33,34,38],"li",{},"Öffne die Seite ",[35,36,20],"a",{"href":37},"\u002Fapi-keys",".",[31,40,41,42,38],{},"Vergib einen Namen (z. B. „Import-Skript\") und klicke auf ",[18,43,44],{},"Erstellen",[31,46,47,48,51],{},"Kopiere den Schlüssel ",[18,49,50],{},"sofort"," – er wird aus Sicherheitsgründen nur\ndieses eine Mal angezeigt. Gespeichert wird nur ein Hash; der Schlüssel\nselbst lässt sich später nicht wiederherstellen.",[14,53,54,55,59],{},"Ein Schlüssel hat die Form ",[56,57,58],"code",{},"ef_"," gefolgt von einer zufälligen Zeichenkette.",[23,61,63],{"id":62},"schlüssel-verwenden","Schlüssel verwenden",[14,65,66,67,70],{},"Sende den Schlüssel als Bearer-Token im ",[56,68,69],{},"Authorization","-Header:",[72,73,78],"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl https:\u002F\u002Feventfalcon.de\u002Fapi\u002Fevents \\\n  -H \"Authorization: Bearer ef_dein_schluessel\"\n","bash","",[56,79,80,97],{"__ignoreMap":77},[81,82,85,89,93],"span",{"class":83,"line":84},"line",1,[81,86,88],{"class":87},"sBMFI","curl",[81,90,92],{"class":91},"sfazB"," https:\u002F\u002Feventfalcon.de\u002Fapi\u002Fevents",[81,94,96],{"class":95},"sTEyZ"," \\\n",[81,98,100,103,107,110],{"class":83,"line":99},2,[81,101,102],{"class":91},"  -H",[81,104,106],{"class":105},"sMK4o"," \"",[81,108,109],{"class":91},"Authorization: Bearer ef_dein_schluessel",[81,111,112],{"class":105},"\"\n",[14,114,115,116,119],{},"Alternativ wird der Header ",[56,117,118],{},"X-API-Key"," akzeptiert:",[72,121,123],{"className":74,"code":122,"language":76,"meta":77,"style":77},"curl https:\u002F\u002Feventfalcon.de\u002Fapi\u002Fevents \\\n  -H \"X-API-Key: ef_dein_schluessel\"\n",[56,124,125,133],{"__ignoreMap":77},[81,126,127,129,131],{"class":83,"line":84},[81,128,88],{"class":87},[81,130,92],{"class":91},[81,132,96],{"class":95},[81,134,135,137,139,142],{"class":83,"line":99},[81,136,102],{"class":91},[81,138,106],{"class":105},[81,140,141],{"class":91},"X-API-Key: ef_dein_schluessel",[81,143,112],{"class":105},[23,145,147],{"id":146},"berechtigungen","Berechtigungen",[14,149,150,151,154,155,158],{},"Ein Schlüssel erbt exakt die Rechte seines Besitzers. Er kann nur\nVeranstaltungen und Listen lesen und ändern, die ",[18,152,153],{},"dir"," gehören – der Zugriff\nauf fremde Daten wird serverseitig verhindert. Zugriffe auf Konto-Einstellungen,\nPasswörter oder die Schlüsselverwaltung selbst sind über die API bewusst ",[18,156,157],{},"nicht","\nmöglich.",[14,160,161,162,166],{},"Schlüssel gehören immer dem Hauptkonto. Ein\n",[35,163,165],{"href":164},"\u002Fhilfe\u002Funter-accounts","Unter-Account"," – Redakteur oder Ticketprüfung – kann\nweder einen Schlüssel anlegen noch sich mit einem anmelden; die API arbeitet\ndamit stets im vollen Umfang deines Kontos, nicht im eingeschränkten eines\nUnter-Accounts.",[23,168,170],{"id":169},"schlüssel-widerrufen","Schlüssel widerrufen",[14,172,173,174,176,177,180],{},"Auf der Seite ",[35,175,20],{"href":37}," kannst du jeden Schlüssel widerrufen.\nDanach schlägt jede Anfrage, die ihn verwendet, sofort mit ",[56,178,179],{},"401"," fehl.\nErstelle bei Verdacht auf Kompromittierung einen neuen Schlüssel und widerrufe\nden alten.",[182,183,184],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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);}",{"title":77,"searchDepth":99,"depth":99,"links":186},[187,188,189,190],{"id":25,"depth":99,"text":26},{"id":62,"depth":99,"text":63},{"id":146,"depth":99,"text":147},{"id":169,"depth":99,"text":170},"Alle API-Anfragen werden mit einem persönlichen API-Schlüssel\nauthentifiziert. Es gibt keine gesonderten OAuth-Flows – ein Schlüssel genügt.","md",{},true,"\u002Fdocs\u002Fauthentication",{"title":5,"description":191},"docs\u002Fauthentication","ln3mFwTKWweQdKz2pwmgoX20OnRjHzKtSfgJP0wb0sw",[200,203,204,207,210],{"path":201,"title":202},"\u002Fdocs","Übersicht",{"path":195,"title":5},{"path":205,"title":206},"\u002Fdocs\u002Fevents","Veranstaltungen",{"path":208,"title":209},"\u002Fdocs\u002Flists","Listen",{"path":211,"title":212},"\u002Fdocs\u002Ferrors","Fehler",1788967873810]