{"id":7469,"date":"2024-03-14T10:42:47","date_gmt":"2024-03-14T09:42:47","guid":{"rendered":"https:\/\/kb.apptec360.com\/manual\/knowledgebase\/definicoes-gerais\/acesso-baseado-em-funcoes\/acesso-a-api\/regras-gerais\/"},"modified":"2024-12-04T05:38:08","modified_gmt":"2024-12-04T04:38:08","slug":"regras-gerais","status":"publish","type":"knowledgebase","link":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/knowledgebase\/definicoes-gerais\/acesso-baseado-em-funcoes\/acesso-a-api\/regras-gerais\/","title":{"rendered":"Regras gerais"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li>A API REST est\u00e1 dispon\u00edvel abaixo do URL de base:<\/li>\n<\/ul>\n\n<p>\/public\/external\/api<\/p>\n\n<ul class=\"wp-block-list\">\n<li>Todos os pedidos t\u00eam de ser enviados atrav\u00e9s de POST.  <\/li>\n\n\n\n<li>A API REST s\u00f3 suporta pedidos via HTTPS.  <\/li>\n\n\n\n<li>Os pedidos devem conter os seguintes cabe\u00e7alhos:<\/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\">Edita<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Nome do cabe\u00e7alho<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Valor do cabe\u00e7alho<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Descri\u00e7\u00e3o<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-2 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>Tipo de conte\u00fado<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>aplica\u00e7\u00e3o\/json<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>fixa<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>autentica\u00e7\u00e3o<\/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>Chave da API no separador &#8220;Acesso \u00e0 API&#8221;<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-4 even\">\n\t<td class=\"column-1\"><br\/>\n        <p>assinatura<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Assinatura codificada em base64<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Assinatura do payload gerado com o<\/p><br\/>\n        <p>chave privada do separador &#8220;Acesso \u00e0 API<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>O corpo do pedido deve ser um objeto codificado em json que deve conter os seguintes valores:<\/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\">Edita<\/a><\/caption>\n<tbody class=\"row-hover\">\n<tr class=\"row-1 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>Campo<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>Campo Exemplo Valor<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Descri\u00e7\u00e3o<\/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\/dispositivo\/lista de dispositivos<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Nome da API<\/p><br\/>\n      <\/td>\n<\/tr>\n<tr class=\"row-3 odd\">\n\t<td class=\"column-1\"><br\/>\n        <p>tempo<\/p><br\/>\n      <\/td><td class=\"column-2\"><br\/>\n        <p>1529662725<\/p><br\/>\n      <\/td><td class=\"column-3\"><br\/>\n        <p>Carimbo de data\/hora Unix (UTC) da m\u00e1quina cliente.<\/p><br\/>\n        <p>A diferen\u00e7a de tempo m\u00e1xima permitida<\/p><br\/>\n        <p>entre o cliente e o servidor \u00e9 de 30<\/p><br\/>\n        <p>minutos.<\/p><br\/>\n      <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<ul class=\"wp-block-list\">\n<li>Em caso de sucesso, a API devolve os dados solicitados (ver as consultas abaixo) e um c\u00f3digo de estado HTTP 200.<\/li>\n\n\n\n<li>Se ocorrer um erro, o c\u00f3digo de estado HTTP ser\u00e1 entre 4xx e 5xx, dependendo do erro, e o objeto de resposta conter\u00e1 uma matriz com a chave &#8220;errors&#8221;, que cont\u00e9m uma lista de mensagens de erro leg\u00edveis por humanos.<\/li>\n\n\n\n<li>Se n\u00e3o existirem dados correspondentes para um dispositivo, \u00e9 devolvido um conjunto vazio.<\/li>\n\n\n\n<li>Se um ID de dispositivo n\u00e3o existir, os dados de retorno ser\u00e3o nulos.<\/li>\n<\/ul>\n","protected":false},"parent":7458,"menu_order":0,"template":"","class_list":["post-7469","knowledgebase","type-knowledgebase","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase\/7469","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/types\/knowledgebase"}],"version-history":[{"count":1,"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase\/7469\/revisions"}],"predecessor-version":[{"id":7470,"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase\/7469\/revisions\/7470"}],"up":[{"embeddable":true,"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase\/7458"}],"wp:attachment":[{"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/media?parent=7469"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}