{"id":33815,"date":"2024-03-14T10:42:47","date_gmt":"2024-03-14T09:42:47","guid":{"rendered":"https:\/\/kb.apptec360.com\/manual\/knowledgebase\/general-rules\/"},"modified":"2024-12-04T05:38:11","modified_gmt":"2024-12-04T04:38:11","slug":"general-rules","status":"publish","type":"knowledgebase","link":"https:\/\/kb.apptec360.com\/manual\/hu\/knowledgebase\/general-settings\/role-based-access\/api-access\/general-rules\/","title":{"rendered":"\u00c1ltal\u00e1nos szab\u00e1lyok"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li>A REST API az alap URL alatt \u00e9rhet\u0151 el:<\/li>\n<\/ul>\n\n<p>\/public\/external\/api<\/p>\n\n<ul class=\"wp-block-list\">\n<li>Minden k\u00e9r\u00e9st POST-on kereszt\u00fcl kell elk\u00fcldeni.  <\/li>\n\n\n\n<li>A REST API csak a HTTPS-en kereszt\u00fcl t\u00f6rt\u00e9n\u0151 k\u00e9r\u00e9seket t\u00e1mogatja.  <\/li>\n\n\n\n<li>A k\u00e9r\u00e9seknek a k\u00f6vetkez\u0151 fejl\u00e9ceket kell tartalmazniuk:<\/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\">Szerkeszt\u00e9s<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Fejl\u00e9c neve<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Fejl\u00e9c \u00e9rt\u00e9ke<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Le\u00edr\u00e1s<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-2 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>Content-type<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>application\/json<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>r\u00f6gz\u00edtett<\/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 kulcs az &#8222;API hozz\u00e1f\u00e9r\u00e9s&#8221; f\u00fcl\u00f6n<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-4 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>al\u00e1\u00edr\u00e1s<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Base64 k\u00f3dolt al\u00e1\u00edr\u00e1s<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>A payload al\u00e1\u00edr\u00e1sa, amelyet a<\/p><br\/>\n        <p>priv\u00e1t kulcs az &#8222;API hozz\u00e1f\u00e9r\u00e9s&#8221; lapon<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>A k\u00e9r\u00e9s test\u00e9nek egy json k\u00f3dol\u00e1s\u00fa objektumnak kell lennie, amelynek a k\u00f6vetkez\u0151 \u00e9rt\u00e9keket kell tartalmaznia:<\/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\">Szerkeszt\u00e9s<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Terep<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Mez\u0151 P\u00e9lda \u00c9rt\u00e9k<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Le\u00edr\u00e1s<\/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\/device\/listdevices<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Az API neve<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>id\u0151<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>1529662725<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Az \u00fcgyf\u00e9lg\u00e9p Unix id\u0151b\u00e9lyege (UTC).<\/p><br\/>\n        <p>A maxim\u00e1lisan megengedett id\u0151k\u00fcl\u00f6nbs\u00e9g<\/p><br\/>\n        <p>az \u00fcgyf\u00e9l \u00e9s a kiszolg\u00e1l\u00f3 k\u00f6z\u00f6tt 30<\/p><br\/>\n        <p>percek.<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>Siker eset\u00e9n az API visszak\u00fcldi a k\u00e9rt adatokat (l\u00e1sd az al\u00e1bbi lek\u00e9rdez\u00e9seket) \u00e9s egy 200-as HTTP st\u00e1tuszk\u00f3dot.<\/li>\n\n\n\n<li>Hiba eset\u00e9n a HTTP st\u00e1tuszk\u00f3d a hib\u00e1t\u00f3l f\u00fcgg\u0151en 4xx \u00e9s 5xx k\u00f6z\u00f6tt lesz, \u00e9s a v\u00e1laszobjektum tartalmaz egy t\u00f6mb\u00f6t az &#8222;errors&#8221; kulcs\u00e1val, amely az ember \u00e1ltal olvashat\u00f3 hiba\u00fczenetek list\u00e1j\u00e1t tartalmazza.<\/li>\n\n\n\n<li>Ha nincs megfelel\u0151 adat egy eszk\u00f6zh\u00f6z, akkor egy \u00fcres t\u00f6mb ker\u00fcl visszaad\u00e1sra.<\/li>\n\n\n\n<li>Ha egy eszk\u00f6zazonos\u00edt\u00f3 nem l\u00e9tezik, a visszat\u00e9r\u0151 adat nulla lesz.<\/li>\n<\/ul>\n","protected":false},"parent":33817,"menu_order":0,"template":"","class_list":["post-33815","knowledgebase","type-knowledgebase","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/kb.apptec360.com\/manual\/hu\/wp-json\/wp\/v2\/knowledgebase\/33815","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.apptec360.com\/manual\/hu\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/kb.apptec360.com\/manual\/hu\/wp-json\/wp\/v2\/types\/knowledgebase"}],"version-history":[{"count":2,"href":"https:\/\/kb.apptec360.com\/manual\/hu\/wp-json\/wp\/v2\/knowledgebase\/33815\/revisions"}],"predecessor-version":[{"id":34841,"href":"https:\/\/kb.apptec360.com\/manual\/hu\/wp-json\/wp\/v2\/knowledgebase\/33815\/revisions\/34841"}],"up":[{"embeddable":true,"href":"https:\/\/kb.apptec360.com\/manual\/hu\/wp-json\/wp\/v2\/knowledgebase\/33817"}],"wp:attachment":[{"href":"https:\/\/kb.apptec360.com\/manual\/hu\/wp-json\/wp\/v2\/media?parent=33815"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}