{"id":7486,"date":"2024-03-14T10:49:23","date_gmt":"2024-03-14T09:49:23","guid":{"rendered":"https:\/\/kb.apptec360.com\/manual\/knowledgebase\/definicoes-gerais\/acesso-baseado-em-funcoes\/acesso-a-api\/consultas\/"},"modified":"2024-12-04T05:37:58","modified_gmt":"2024-12-04T04:37:58","slug":"consultas","status":"publish","type":"knowledgebase","link":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/knowledgebase\/definicoes-gerais\/acesso-baseado-em-funcoes\/acesso-a-api\/consultas\/","title":{"rendered":"Consultas"},"content":{"rendered":"\n<p><strong><span style=\"text-decoration: underline;\">Lista todos os dispositivos<\/span><\/strong><\/p>\n\n<p>Funcionalidade: Devolve uma lista de todos os dispositivos com a ID do dispositivo, IMEI e s\u00e9rie<br\/>URI da API: v2\/device\/listdevices<br\/>Par\u00e2metros obrigat\u00f3rios: nenhum<br\/>Par\u00e2metros opcionais: nenhum<\/p>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de pedido<\/span><\/p>\n\n<pre class=\"wp-block-code\"><code>{\n\"api\": \"v2\/device\/listdevices\",\n\"time\": 1529662725\n}\n<\/code><\/pre>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de resposta<\/span><\/p>\n\n<pre class=\"wp-block-code\"><code>{\n\"errors\": &#91;],\n\"list\":&#91;\n{ \"id\":\"10\",\"serial\":\"987612345\",\"imei\":\"899938455454\"},\n{ \"id\":\"11\",\"serial\":\"619723118\",\"imei\":\"713032378599\"}\n]\n}\n<\/code><\/pre>\n\n<div class=\"pagebreak-after\"><\/div>\n\n<p><strong><span style=\"text-decoration: underline;\">Obt\u00e9m uma lista de posi\u00e7\u00f5es (GPS)<\/span><\/strong><\/p>\n\n<p>Funcionalidade: Devolve uma lista de todas as entradas de registo de posi\u00e7\u00e3o armazenadas para ids de dispositivos<br\/>API URI: v2\/device\/listposition<br\/>Par\u00e2metros obrigat\u00f3rios: &#8220;ids&#8221; &#8211; Conjunto de IDs de dispositivos<br\/>Par\u00e2metros opcionais: nenhum<\/p>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de pedido<\/span><\/p>\n\n<pre class=\"wp-block-code\"><code>{<br>\"api\": \"device\/listposition\",<br>\"params\": {<br>\"ids\": &#91;10, 11]<br>},<br>\"time\": 1529662725<br>}<\/code><\/pre>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de resposta<\/span><\/p>\n\n<pre class=\"wp-block-code\"><code>{<br>\"errors\": &#91;],<br>\"list\":&#91;<br>\"10\":&#91;<br>{\"time\":\"1529632725\",\"pos\":\"47.5572,7.5967\"},<br>{\"time\":\"1529642725\",\"pos\":\"47.5572,7.5968\"},<br>{\"time\":\"1529652725\",\"pos\":\"47.5573,7.5969\"},<br>],<br>\"88\":&#91;],<br>]<br>}<\/code><\/pre>\n\n<div class=\"pagebreak-after\"><\/div>\n\n<p><strong><span style=\"text-decoration: underline;\">Obter mapa de activos<\/span><\/strong><\/p>\n\n<p>Funcionamento:<br\/>Devolve uma lista de todos os poss\u00edveis activos armazenados a solicitar utilizando a op\u00e7\u00e3o Obter quaisquer dados de activos.<br\/>Podes utilizar o formul\u00e1rio leg\u00edvel por humanos ou a etiqueta do imobilizado para solicitar os dados.<br\/>URI da API: v2\/device\/getassetmap<br\/>Par\u00e2metros obrigat\u00f3rios: nenhum<br\/>Par\u00e2metros opcionais: nenhum<\/p>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de pedido<\/span><\/p>\n\n<pre class=\"wp-block-code\"><code>{<br>\"api\": \"v2\/device\/getassetmap\",<br>\"time\": 1529662725<br>}<\/code><\/pre>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de resposta<\/span><\/p>\n\n<p>Esta resposta foi encurtada para facilitar a leitura.<\/p>\n\n<pre class=\"wp-block-code\"><code>{<br>\"AssetKeys\": {<br>\"UDID\": \"AT001\",<br>\"Device Alias\": \"AT002\",<br>\"OS Version WinMobile iOS MacOS\": \"AT003\",<br>\"Model Name\": \"AT004\",<br>\"Serial Number\": \"AT005\",<br>\"Total Storage\": \"AT006\",<br>\"Free Storage\": \"AT007\",<br>\"IMEI\": \"AT008\",<br>\u2026<br>\"apptecID\": \"APPTECID\"<br>},<br>\"errors\": &#91;]<br>}<\/code><\/pre>\n\n<div class=\"pagebreak-after\"><\/div>\n\n<p><strong><span style=\"text-decoration: underline;\">Obt\u00e9m quaisquer dados de activos<\/span><\/strong><\/p>\n\n<p>Funcionalidade: Devolve uma lista de dados de activos solicitados para ids de dispositivos<br\/>URI da API: v2\/device\/getassetdata<br\/>Par\u00e2metros obrigat\u00f3rios: &#8220;ids&#8221; &#8211; Conjunto de IDs de dispositivos<br\/>Par\u00e2metros opcionais:<br\/>&#8220;assetkeys&#8221; &#8211; Chaves de dados do ativo a devolver. Se n\u00e3o for especificado, todos os dados de activos dispon\u00edveis ser\u00e3o<br\/>devolvido. Podes obter uma lista de chaves de activos utilizando Obter mapa de activos.<\/p>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de pedido<\/span><\/p>\n\n<pre class=\"wp-block-code\"><code>{<br>\"api\": \"v2\/device\/getassetdata\",<br>\"time\": 1529662725,<br>\"params\": {<br>\"ids\": &#91;<br>26<br>],<br>\"assetkeys\": &#91;<br>\"imei\"<br>]<br>}<br>}<\/code><\/pre>\n\n<p><span style=\"text-decoration: underline;\">Exemplo de corpo de resposta<\/span><\/p>\n\n<pre class=\"wp-block-code\"><code>{<br>\"result\": {<br>\"26\": {<br>\"imei\": \"349157642516427\u201d<br>}<br>},<br>\"errors\": &#91;]<br>}<\/code><\/pre>\n\n<div class=\"pagebreak-after\"><\/div>\n","protected":false},"parent":7458,"menu_order":0,"template":"","class_list":["post-7486","knowledgebase","type-knowledgebase","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase\/7486","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":5,"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase\/7486\/revisions"}],"predecessor-version":[{"id":7495,"href":"https:\/\/kb.apptec360.com\/manual\/pt-pt\/wp-json\/wp\/v2\/knowledgebase\/7486\/revisions\/7495"}],"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=7486"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}