{"id":31858,"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:10","modified_gmt":"2024-12-04T04:38:10","slug":"general-rules","status":"publish","type":"knowledgebase","link":"https:\/\/kb.apptec360.com\/manual\/fi\/knowledgebase\/general-settings\/role-based-access\/api-access\/general-rules\/","title":{"rendered":"Yleiset s\u00e4\u00e4nn\u00f6t"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li>REST API on saatavilla perus URL-osoitteen alapuolella:<\/li>\n<\/ul>\n\n<p>\/public\/external\/api<\/p>\n\n<ul class=\"wp-block-list\">\n<li>Kaikki pyynn\u00f6t on l\u00e4hetett\u00e4v\u00e4 POST-palveluna.  <\/li>\n\n\n\n<li>REST API tukee vain HTTPS-pyynt\u00f6j\u00e4.  <\/li>\n\n\n\n<li>Pyynt\u00f6jen on sis\u00e4llett\u00e4v\u00e4 seuraavat otsikot:<\/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\">Muokkaa<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Otsikon nimi<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Otsikon arvo<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Kuvaus<\/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>kiinte\u00e4<\/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-avain &#8221;API Access&#8221; -v\u00e4lilehdelt\u00e4<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-4 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>allekirjoitus<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Base64-koodattu allekirjoitus<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Palkkion allekirjoitus, joka on luotu<\/p><br\/>\n        <p>yksityinen avain &#8221;API Access&#8221; -v\u00e4lilehdelt\u00e4<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>Pyynn\u00f6n rungon on oltava json-koodattu objekti, jonka on sis\u00e4llett\u00e4v\u00e4 seuraavat arvot:<\/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\">Muokkaa<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Kentt\u00e4<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Kentt\u00e4 Esimerkki Arvo<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Kuvaus<\/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>API:n nimi<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>aika<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>1529662725<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Asiakaskoneen Unix-aikaleima (UTC).<\/p><br\/>\n        <p>Suurin sallittu aikaero<\/p><br\/>\n        <p>asiakkaan ja palvelimen v\u00e4lill\u00e4 on 30<\/p><br\/>\n        <p>minuuttia.<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>Onnistuessaan API palauttaa pyydetyt tiedot (katso kyselyt alla) ja HTTP-tilakoodin 200.<\/li>\n\n\n\n<li>Jos virhe tapahtuu, HTTP-tilakoodi on 4xx ja 5xx virheen mukaan, ja vastausobjekti sis\u00e4lt\u00e4\u00e4 sarjan, jonka avain on &#8221;errors&#8221; ja joka sis\u00e4lt\u00e4\u00e4 luettelon ihmiselle luettavissa olevista virheilmoituksista.<\/li>\n\n\n\n<li>Jos laitteelle ei l\u00f6ydy vastaavia tietoja, palautetaan tyhj\u00e4 array.<\/li>\n\n\n\n<li>Jos laitteen tunnusta ei ole olemassa, sen palautustiedot ovat nolla.<\/li>\n<\/ul>\n","protected":false},"parent":31860,"menu_order":0,"template":"","class_list":["post-31858","knowledgebase","type-knowledgebase","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/kb.apptec360.com\/manual\/fi\/wp-json\/wp\/v2\/knowledgebase\/31858","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.apptec360.com\/manual\/fi\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/kb.apptec360.com\/manual\/fi\/wp-json\/wp\/v2\/types\/knowledgebase"}],"version-history":[{"count":2,"href":"https:\/\/kb.apptec360.com\/manual\/fi\/wp-json\/wp\/v2\/knowledgebase\/31858\/revisions"}],"predecessor-version":[{"id":33122,"href":"https:\/\/kb.apptec360.com\/manual\/fi\/wp-json\/wp\/v2\/knowledgebase\/31858\/revisions\/33122"}],"up":[{"embeddable":true,"href":"https:\/\/kb.apptec360.com\/manual\/fi\/wp-json\/wp\/v2\/knowledgebase\/31860"}],"wp:attachment":[{"href":"https:\/\/kb.apptec360.com\/manual\/fi\/wp-json\/wp\/v2\/media?parent=31858"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}