{"id":13404,"date":"2024-03-14T10:42:47","date_gmt":"2024-03-14T09:42:47","guid":{"rendered":"https:\/\/kb.apptec360.com\/manual\/knowledgebase\/rollenbasierter-zugriff\/api-zugang\/allgemeine-regeln\/"},"modified":"2024-12-04T05:38:08","modified_gmt":"2024-12-04T04:38:08","slug":"allgemeine-regeln","status":"publish","type":"knowledgebase","link":"https:\/\/kb.apptec360.com\/manual\/de\/knowledgebase\/allgemeine-einstellungen\/rollenbasierter-zugriff\/api-zugang\/allgemeine-regeln\/","title":{"rendered":"Allgemeine Regeln"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li>Die REST-API ist unterhalb der Basis-URL verf\u00fcgbar:<\/li>\n<\/ul>\n\n<p>\/public\/external\/api<\/p>\n\n<ul class=\"wp-block-list\">\n<li>Alle Anfragen m\u00fcssen per POST gesendet werden.  <\/li>\n\n\n\n<li>Die REST-API unterst\u00fctzt nur Anfragen \u00fcber HTTPS.  <\/li>\n\n\n\n<li>Die Anfragen m\u00fcssen die folgenden Kopfzeilen enthalten:<\/li>\n<\/ul>\n\n<table id=\"tablepress-6\" class=\"tablepress tablepress-id-6\">\n<caption style=\"caption-side:bottom;text-align:left;border:none;background:none;margin:0;padding:0;\"><a href=\"https:\/\/kb.apptec360.com\/manual\/wp-admin\/admin.php?page=tablepress&#038;action=edit&#038;table_id=6\" rel=\"nofollow\">bearbeiten<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Kopfzeile Name<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Kopfzeile Wert<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Beschreibung<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-2 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>Inhaltstyp<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>anwendung\/json<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>fest<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>auth<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>123&#8230;xyz<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>API-Schl\u00fcssel auf der Registerkarte &#8222;API-Zugang&#8220;.<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-4 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>Unterschrift<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Base64 kodierte Signatur<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Signatur der Nutzdaten, die mit dem<\/p><br\/>\n        <p>privaten Schl\u00fcssel auf der Registerkarte &#8222;API-Zugang<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>Der Request Body muss ein json kodiertes Objekt sein, das die folgenden Werte enth\u00e4lt:<\/li>\n<\/ul>\n\n<div class=\"pagebreak-after\"><\/div>\n\n<table id=\"tablepress-7\" class=\"tablepress tablepress-id-7\">\n<caption style=\"caption-side:bottom;text-align:left;border:none;background:none;margin:0;padding:0;\"><a href=\"https:\/\/kb.apptec360.com\/manual\/wp-admin\/admin.php?page=tablepress&#038;action=edit&#038;table_id=7\" rel=\"nofollow\">bearbeiten<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Feld<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Feld Beispielwert<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Beschreibung<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-2 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>api<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>v2\/Ger\u00e4t\/ListeGer\u00e4te<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Name der API<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Zeit<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>1529662725<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Unix-Zeitstempel (UTC) des Client-Rechners.<\/p><br\/>\n        <p>Die maximal zul\u00e4ssige Zeitdifferenz<\/p><br\/>\n        <p>zwischen dem Client und dem Server betr\u00e4gt 30<\/p><br\/>\n        <p>Minuten.<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>Bei Erfolg gibt die API die angeforderten Daten (siehe die Abfragen unten) und einen HTTP-Statuscode 200 zur\u00fcck.<\/li>\n\n\n\n<li>Wenn ein Fehler auftritt, ist der HTTP-Statuscode je nach Fehler zwischen 4xx und 5xx und das Antwortobjekt enth\u00e4lt ein Array mit dem Schl\u00fcssel &#8222;errors&#8220;, das eine Liste von menschenlesbaren Fehlermeldungen enth\u00e4lt.<\/li>\n\n\n\n<li>Wenn es keine passenden Daten f\u00fcr ein Ger\u00e4t gibt, wird ein leeres Array zur\u00fcckgegeben.<\/li>\n\n\n\n<li>Wenn eine Ger\u00e4te-ID nicht existiert, sind die R\u00fcckgabedaten Null.<\/li>\n<\/ul>\n","protected":false},"parent":13399,"menu_order":0,"template":"","class_list":["post-13404","knowledgebase","type-knowledgebase","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/kb.apptec360.com\/manual\/de\/wp-json\/wp\/v2\/knowledgebase\/13404","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.apptec360.com\/manual\/de\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/kb.apptec360.com\/manual\/de\/wp-json\/wp\/v2\/types\/knowledgebase"}],"version-history":[{"count":1,"href":"https:\/\/kb.apptec360.com\/manual\/de\/wp-json\/wp\/v2\/knowledgebase\/13404\/revisions"}],"predecessor-version":[{"id":13407,"href":"https:\/\/kb.apptec360.com\/manual\/de\/wp-json\/wp\/v2\/knowledgebase\/13404\/revisions\/13407"}],"up":[{"embeddable":true,"href":"https:\/\/kb.apptec360.com\/manual\/de\/wp-json\/wp\/v2\/knowledgebase\/13399"}],"wp:attachment":[{"href":"https:\/\/kb.apptec360.com\/manual\/de\/wp-json\/wp\/v2\/media?parent=13404"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}