Bem-vindo à API pública da Mettrix — a plataforma inteligente de monitoramento de tanques.
\nEsta collection contém todos os endpoints disponíveis para integração com seus sistemas (ERP, BI, dashboards, automações).
\nVocê pode gerar uma chave de API acessando seu perfil na plataforma e clicando em \"Chaves de API\" (https://app.mettrix.com.br/account/api-keys). A chave segue o formato:
\nmk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n\nAntes de usar, configure as variáveis abaixo na aba Variables desta collection:
\nExecute a request Health Check para validar a conectividade e depois Minha Conta para validar sua API Key.
\nTodas as requisições (exceto /health) devem incluir o header:
X-API-Key: mk_sua_chave_aqui\n\nA autenticação já está configurada no nível da collection — basta preencher a variável api_key.
Ao exceder o limite, a API retorna HTTP 429 Too Many Requests.
\nEndpoints que retornam listas suportam paginação via query parameters:
\nExemplo: Para buscar a segunda página com 50 itens:
\nGET /v1/tanks/?skip=50&limit=50\n\nTodas as respostas são em JSON (UTF-8)
\nDatas seguem o padrão ISO 8601 (2026-02-25T14:30:00Z)
IDs são UUIDs v4 (c1d2e3f4-5678-90ab-cdef-aabbccddeeff)
Volumes em litros, temperaturas em °C, distâncias em cm
\nPorcentagens como números decimais (ex: 56.3 = 56.3%)
Em caso de dúvidas ou problemas, entre em contato com o administrador da sua conta Mettrix ou acesse a central de ajuda.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"52765174","collectionId":"18ac587f-2864-4458-bf04-adf055ff23ab","publishedId":"2sBXcHheFt","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-27T13:40:29.000Z"},"item":[{"name":"Primeiros Passos","item":[{"name":"Health Check","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('API está operacional', function () {"," pm.response.to.have.status(200);","});","","pm.test('Status é healthy', function () {"," const json = pm.response.json();"," pm.expect(json.status).to.eql('healthy');","});","","pm.test('Versão da API está presente', function () {"," const json = pm.response.json();"," pm.expect(json.version).to.be.a('string');"," console.log('[Mettrix] Versão da API: ' + json.version);","});"],"id":"c5e61619-57e5-4dc8-b2de-c754e51476fb"}}],"id":"49ba5e55-a76f-4588-b2ea-c05ce604e951","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://connect.mettrix.com.br/health","description":"Verifica se o serviço da API está operacional.
\nEste endpoint não requer autenticação — ideal para validar a conectividade antes de configurar sua API Key.
\nRetorna informações do usuário vinculado à API Key e as empresas acessíveis.
\ncompany_id necessário para filtrar tanques por empresaO script de testes salva automaticamente o company_id da primeira empresa na variável da collection para uso nos próximos endpoints.
Endpoints para validar sua conexão e autenticação com a API Mettrix.
\nComece pelo Health Check para verificar se a API está acessível e depois use Minha Conta para validar sua API Key e descobrir quais empresas e permissões estão vinculadas.
\nOrdem sugerida:
\nRetorna a lista de tanques das suas empresas com informações resumidas.
\ntank_id necessários para outras consultasO script de testes salva automaticamente o tank_id do primeiro tanque retornado para uso nos próximos endpoints.
Filtrar por empresa específica (UUID). Sem filtro retorna tanques de todas as empresas.
\n","type":"text/plain"},"key":"company_id","value":""},{"disabled":true,"description":{"content":"Buscar por nome do tanque, localização ou produto armazenado.
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"Apenas tanques ativos. Default: true.
\n","type":"text/plain"},"key":"only_active","value":"true"},{"disabled":true,"description":{"content":"Offset para paginação. Default: 0.
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Máximo de resultados por página (1-500). Default: 100.
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[]}},"response":[{"id":"31951045-0537-4b75-b0ef-ce4f2c11f909","name":"200 - Lista de tanques","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/?only_active=true&limit=100","host":["https://connect.mettrix.com.br"],"path":["v1","tanks",""],"query":[{"key":"only_active","value":"true"},{"key":"limit","value":"100"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"100"},{"key":"X-RateLimit-Remaining","value":"97"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"name\": \"Tanque Diesel #01\",\n \"is_active\": true,\n \"specifications\": {\n \"shape\": \"cylinder\",\n \"orientation\": \"horizontal\",\n \"height_cm\": 250.0,\n \"diameter_cm\": 180.0,\n \"capacity_liters\": 15000.0\n },\n \"product\": {\n \"product_type\": \"fuel\",\n \"substance_type\": \"Diesel S10\",\n \"substance_subcategory\": null\n },\n \"current_reading\": {\n \"current_volume_liters\": 8450.5,\n \"current_level_percent\": 56.3,\n \"last_reading_at\": \"2026-02-25T14:30:00Z\"\n },\n \"zones\": [\n {\n \"id\": \"d4e5f6a7-1234-5678-abcd-ef0123456789\",\n \"order\": 1,\n \"label\": \"Crítico\",\n \"max_level_percent\": 15.0,\n \"color\": \"#FF0000\",\n \"enable_alerts\": true\n },\n {\n \"id\": \"a7b8c9d0-5678-9012-cdef-345678901234\",\n \"order\": 2,\n \"label\": \"Normal\",\n \"max_level_percent\": 80.0,\n \"color\": \"#00CC00\",\n \"enable_alerts\": false\n }\n ],\n \"exhaustion_estimate\": {\n \"estimated_days_remaining\": 18.5,\n \"estimated_exhaustion_date\": \"2026-03-15T00:00:00Z\",\n \"average_daily_consumption\": 456.8,\n \"calculation_period_days\": 7,\n \"data_points_count\": 42,\n \"confidence_level\": \"high\"\n },\n \"created_at\": \"2025-06-15T10:00:00Z\",\n \"updated_at\": \"2026-02-25T14:30:00Z\"\n }\n]"},{"id":"b685b167-4466-4a71-ab1d-2e1ca7a592df","name":"200 - Lista vazia (sem tanques)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/?only_active=true&limit=100","host":["https://connect.mettrix.com.br"],"path":["v1","tanks",""],"query":[{"key":"only_active","value":"true"},{"key":"limit","value":"100"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[]"},{"id":"3f993e77-c89e-4911-a7e2-1c867e543cf7","name":"422 - Erro de validação","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/?limit=9999","host":["https://connect.mettrix.com.br"],"path":["v1","tanks",""],"query":[{"key":"limit","value":"9999"}]}},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\"query\", \"limit\"],\n \"msg\": \"Input should be less than or equal to 500\",\n \"type\": \"less_than_equal\",\n \"input\": 9999,\n \"ctx\": {\n \"le\": 500\n }\n }\n ]\n}"}],"_postman_id":"00342475-0dee-4045-9160-9033c1d9eb1f"},{"name":"Detalhes do Tanque","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Requisição bem-sucedida', function () {"," pm.response.to.have.status(200);","});","","pm.test('Tanque possui campos obrigatórios', function () {"," const json = pm.response.json();"," pm.expect(json).to.have.property('id');"," pm.expect(json).to.have.property('name');"," pm.expect(json).to.have.property('is_active');","});","","pm.test('Leitura atual presente', function () {"," const json = pm.response.json();"," if (json.current_reading) {"," console.log('[Mettrix] ' + json.name + ': ' +"," json.current_reading.current_level_percent + '% | ' +"," json.current_reading.current_volume_liters + ' litros');"," }","});","","pm.test('Estimativa de esgotamento presente', function () {"," const json = pm.response.json();"," if (json.exhaustion_estimate && json.exhaustion_estimate.estimated_days_remaining) {"," console.log('[Mettrix] Dias restantes: ' +"," json.exhaustion_estimate.estimated_days_remaining +"," ' | Confiança: ' + json.exhaustion_estimate.confidence_level);"," }","});"],"id":"6c4618fe-7aac-4d10-a263-b02ba36fed30"}}],"id":"4e197e7e-9d58-4533-a76e-41099f486d7a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff?include_exhaustion_estimate=true","description":"Retorna todas as informações de um tanque específico.
\nQuando habilitada, retorna o campo exhaustion_estimate com:
A confiança depende da quantidade e consistência dos dados históricos disponíveis.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"mk_sua_chave_aqui"}]},"isInherited":true,"source":{"_postman_id":"18ac587f-2864-4458-bf04-adf055ff23ab","id":"18ac587f-2864-4458-bf04-adf055ff23ab","name":"Mettrix Public API","type":"collection"}},"urlObject":{"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff"],"host":["https://connect.mettrix.com.br"],"query":[{"description":{"content":"Incluir estimativa de esgotamento calculada com base no consumo recente. Default: true.
\n","type":"text/plain"},"key":"include_exhaustion_estimate","value":"true"}],"variable":[]}},"response":[{"id":"7ad29de6-3187-43b0-bedb-c8bc9530c3dc","name":"200 - Detalhes completos","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff?include_exhaustion_estimate=true","host":["https://connect.mettrix.com.br"],"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff"],"query":[{"key":"include_exhaustion_estimate","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"name\": \"Tanque Diesel #01\",\n \"is_active\": true,\n \"specifications\": {\n \"shape\": \"cylinder\",\n \"orientation\": \"horizontal\",\n \"height_cm\": 250.0,\n \"diameter_cm\": 180.0,\n \"capacity_liters\": 15000.0\n },\n \"product\": {\n \"product_type\": \"fuel\",\n \"substance_type\": \"Diesel S10\",\n \"substance_subcategory\": null\n },\n \"current_reading\": {\n \"current_volume_liters\": 8450.5,\n \"current_level_percent\": 56.3,\n \"last_reading_at\": \"2026-02-25T14:30:00Z\"\n },\n \"zones\": [\n {\n \"id\": \"d4e5f6a7-1234-5678-abcd-ef0123456789\",\n \"order\": 1,\n \"label\": \"Crítico\",\n \"max_level_percent\": 15.0,\n \"color\": \"#FF0000\",\n \"enable_alerts\": true\n },\n {\n \"id\": \"a7b8c9d0-5678-9012-cdef-345678901234\",\n \"order\": 2,\n \"label\": \"Normal\",\n \"max_level_percent\": 80.0,\n \"color\": \"#00CC00\",\n \"enable_alerts\": false\n }\n ],\n \"exhaustion_estimate\": {\n \"estimated_days_remaining\": 18.5,\n \"estimated_exhaustion_date\": \"2026-03-15T00:00:00Z\",\n \"average_daily_consumption\": 456.8,\n \"calculation_period_days\": 7,\n \"data_points_count\": 42,\n \"confidence_level\": \"high\"\n },\n \"created_at\": \"2025-06-15T10:00:00Z\",\n \"updated_at\": \"2026-02-25T14:30:00Z\"\n}"},{"id":"e7d42423-b8d5-4d8a-bc7d-f1e86839d82c","name":"404 - Tanque não encontrado","originalRequest":{"method":"GET","header":[],"url":"https://connect.mettrix.com.br/v1/tanks/00000000-0000-0000-0000-000000000000"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"Tanque não encontrado ou sem permissão de acesso.\"\n}"}],"_postman_id":"4e197e7e-9d58-4533-a76e-41099f486d7a"}],"id":"dadb9bfe-0754-4c71-a8c9-0090841eb936","description":"Endpoints para consultar tanques monitorados pela Mettrix.
\nOs tanques são o recurso central da API. Cada tanque possui:
\nRetorna o histórico de leituras (medições) de um tanque, com suporte a filtro por período.
\nstart_date=2026-02-01&end_date=2026-02-28start_date=2026-02-20&end_date=2026-02-27limitSe o tanque possui muitas leituras, use a paginação:
\nPágina 1: ?skip=0&limit=5000\nPágina 2: ?skip=5000&limit=5000\n...\nOu restrinja o período com start_date e end_date.
Data início no formato ISO 8601 (ex: 2026-02-01). Sem filtro retorna as leituras mais recentes.
\n","type":"text/plain"},"key":"start_date","value":"2026-02-01"},{"disabled":true,"description":{"content":"Data fim no formato ISO 8601 (ex: 2026-02-28).
\n","type":"text/plain"},"key":"end_date","value":"2026-02-28"},{"disabled":true,"description":{"content":"Offset para paginação. Default: 0.
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Máximo de resultados por página (1-5000). Default: 1000.
\n","type":"text/plain"},"key":"limit","value":"1000"}],"variable":[]}},"response":[{"id":"96a8106b-f9a6-42cb-8515-fe2d0d65ba0c","name":"200 - Leituras do período","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/readings?limit=1000","host":["https://connect.mettrix.com.br"],"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff","readings"],"query":[{"key":"limit","value":"1000"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"b2c3d4e5-6789-0abc-def1-234567890abc\",\n \"tank_id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"volume_liters\": 8450.5,\n \"level_percent\": 56.3,\n \"temperature\": 24.5,\n \"distance_cm\": 109.7,\n \"reading_at\": \"2026-02-25T14:30:00Z\"\n },\n {\n \"id\": \"a1b2c3d4-0000-1111-2222-333344445555\",\n \"tank_id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"volume_liters\": 8520.1,\n \"level_percent\": 56.8,\n \"temperature\": 24.2,\n \"distance_cm\": 109.3,\n \"reading_at\": \"2026-02-25T13:30:00Z\"\n },\n {\n \"id\": \"f6e5d4c3-b2a1-9876-5432-109876543210\",\n \"tank_id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"volume_liters\": 8605.7,\n \"level_percent\": 57.4,\n \"temperature\": 23.8,\n \"distance_cm\": 108.8,\n \"reading_at\": \"2026-02-25T12:30:00Z\"\n }\n]"}],"_postman_id":"a598fd22-20d5-4131-bb9a-bcf765b9da1d"},{"name":"Alertas do Tanque","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Requisição bem-sucedida', function () {"," pm.response.to.have.status(200);","});","","pm.test('Resposta é um array de alertas', function () {"," const json = pm.response.json();"," pm.expect(json).to.be.an('array');"," console.log('[Mettrix] Total de alertas: ' + json.length);",""," const active = json.filter(a => !a.is_resolved);"," const resolved = json.filter(a => a.is_resolved);"," console.log('[Mettrix] Ativos: ' + active.length + ' | Resolvidos: ' + resolved.length);",""," if (active.length > 0) {"," console.warn('[Mettrix] ATENÇÃO: Existem ' + active.length + ' alerta(s) ativo(s)!');"," }","});"],"id":"10e9df0d-a4fb-4e08-9cd3-d28c3d8d22bc"}}],"id":"7da324ab-62c7-45c6-a4bf-faf19ee6fd8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/alerts?limit=100","description":"Retorna os alertas disparados para um tanque, ordenados do mais recente para o mais antigo.
\nis_resolved: false — Alerta ainda ativo, tanque permanece na zona de alertais_resolved: true — Alerta resolvido, tanque saiu da zona de alertaresolved_at — Indica quando o nível voltou ao normalOffset para paginação. Default: 0.
\n","type":"text/plain"},"key":"skip","value":"0"},{"description":{"content":"Máximo de resultados por página (1-500). Default: 100.
\n","type":"text/plain"},"key":"limit","value":"100"}],"variable":[]}},"response":[{"id":"47e6edad-b8ae-46e1-a3e0-b7626a23dab0","name":"200 - Alertas do tanque","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/alerts?limit=100","host":["https://connect.mettrix.com.br"],"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff","alerts"],"query":[{"key":"limit","value":"100"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"e5f6a7b8-9012-3456-cdef-abcdef012345\",\n \"tank_id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"zone_id\": \"d4e5f6a7-1234-5678-abcd-ef0123456789\",\n \"zone_label\": \"Crítico\",\n \"alert_type\": \"low_level\",\n \"level_percent\": 12.5,\n \"message\": \"Nível do tanque Diesel #01 atingiu zona Crítico (12.5%)\",\n \"triggered_at\": \"2026-02-20T08:15:00Z\",\n \"resolved_at\": \"2026-02-20T16:30:00Z\",\n \"is_resolved\": true\n },\n {\n \"id\": \"b1c2d3e4-5678-9abc-def0-112233445566\",\n \"tank_id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"zone_id\": \"d4e5f6a7-1234-5678-abcd-ef0123456789\",\n \"zone_label\": \"Crítico\",\n \"alert_type\": \"low_level\",\n \"level_percent\": 14.8,\n \"message\": \"Nível do tanque Diesel #01 atingiu zona Crítico (14.8%)\",\n \"triggered_at\": \"2026-02-10T06:45:00Z\",\n \"resolved_at\": \"2026-02-10T11:20:00Z\",\n \"is_resolved\": true\n }\n]"},{"id":"74fa666b-7a32-4a95-9b89-3ca76ec6e667","name":"200 - Sem alertas","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/alerts?limit=100","host":["https://connect.mettrix.com.br"],"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff","alerts"],"query":[{"key":"limit","value":"100"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[]"}],"_postman_id":"7da324ab-62c7-45c6-a4bf-faf19ee6fd8f"}],"id":"aa543d82-ae9d-495d-a384-5373b853711d","description":"Endpoints para consultar o histórico de leituras (medições de volume, nível e temperatura) e alertas disparados pelos tanques.
\nCada leitura contém os dados capturados pelo sensor em um momento específico:
\nAlertas são disparados quando o nível do tanque entra em uma zona configurada (ex: zona Crítico quando nível < 15%).
\n","_postman_id":"aa543d82-ae9d-495d-a384-5373b853711d","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":"mk_sua_chave_aqui"}]},"isInherited":true,"source":{"_postman_id":"18ac587f-2864-4458-bf04-adf055ff23ab","id":"18ac587f-2864-4458-bf04-adf055ff23ab","name":"Mettrix Public API","type":"collection"}}},{"name":"Projeções IA","item":[{"name":"Projeção de Volume (IA)","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('Requisição bem-sucedida', function () {"," pm.response.to.have.status(200);","});","","pm.test('Projeção presente na resposta', function () {"," const json = pm.response.json();"," pm.expect(json).to.have.property('volume_projection');","});","","pm.test('Verificar resultado da projeção', function () {"," const json = pm.response.json();"," const proj = json.volume_projection;",""," if (!proj) return;",""," console.log('[Mettrix] Método: ' + proj.calculation_method);"," console.log('[Mettrix] Confiança: ' + proj.confidence_level);"," console.log('[Mettrix] Pontos de dados: ' + proj.data_points_used);",""," if (proj.projected_volume !== null) {"," console.log('[Mettrix] Volume projetado: ' + proj.projected_volume + ' litros em ' + proj.projection_days + ' dias');"," console.log('[Mettrix] Consumo diário: ' + proj.daily_consumption_rate + ' litros/dia');"," }",""," if (proj.will_be_empty) {"," console.warn('[Mettrix] ATENÇÃO: Tanque vai esvaziar em ' + proj.empty_date);"," }",""," if (proj.confidence_level === 'insufficient_data') {"," console.warn('[Mettrix] Dados insuficientes. Aumente o calculation_period_days.');"," }","});"],"id":"8905ab60-babe-439d-b2f1-598790b1cbf7"}}],"id":"3f111591-7562-44d6-9c36-65ec62b4c0f5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/volume-projection?projection_days=7&calculation_period_days=60","description":"Calcula a projeção de volume futuro de um tanque utilizando inteligência artificial (Prophet ML).
\nAumente o calculation_period_days para projeções mais confiáveis em tanques com consumo variável. Para tanques com consumo estável, períodos menores já oferecem boa precisão.
Número de dias para projetar no futuro (1-365). Default: 7.
\n","type":"text/plain"},"key":"projection_days","value":"7"},{"description":{"content":"Período de histórico usado para cálculo (7-365 dias). Default: 60. Quanto maior, mais dados o modelo usa.
\n","type":"text/plain"},"key":"calculation_period_days","value":"60"}],"variable":[]}},"response":[{"id":"434f08ab-a88a-405e-aa12-1aedf33835b5","name":"200 - Projeção com alta confiança","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/volume-projection?projection_days=7&calculation_period_days=60","host":["https://connect.mettrix.com.br"],"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff","volume-projection"],"query":[{"key":"projection_days","value":"7"},{"key":"calculation_period_days","value":"60"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"name\": \"Tanque Diesel #01\",\n \"is_active\": true,\n \"volume_projection\": {\n \"projected_volume\": 5280.3,\n \"projection_days\": 7,\n \"projection_date\": \"2026-03-04T00:00:00Z\",\n \"confidence_level\": \"high\",\n \"calculation_method\": \"prophet_ml\",\n \"daily_consumption_rate\": 456.8,\n \"data_points_used\": 42,\n \"message\": \"Projeção calculada com alta confiança usando Prophet ML\",\n \"notes\": \"Padrão de consumo estável detectado\",\n \"will_be_empty\": false,\n \"empty_date\": null\n }\n}"},{"id":"f0432190-a89d-45f8-bf31-453c1aed2e4e","name":"200 - Tanque vai esvaziar","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/volume-projection?projection_days=30&calculation_period_days=60","host":["https://connect.mettrix.com.br"],"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff","volume-projection"],"query":[{"key":"projection_days","value":"30"},{"key":"calculation_period_days","value":"60"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"name\": \"Tanque Diesel #01\",\n \"is_active\": true,\n \"volume_projection\": {\n \"projected_volume\": 0,\n \"projection_days\": 30,\n \"projection_date\": \"2026-03-27T00:00:00Z\",\n \"confidence_level\": \"high\",\n \"calculation_method\": \"prophet_ml\",\n \"daily_consumption_rate\": 456.8,\n \"data_points_used\": 42,\n \"message\": \"ATENÇÃO: Tanque ficará vazio antes do período projetado\",\n \"notes\": \"Recomendado agendar abastecimento\",\n \"will_be_empty\": true,\n \"empty_date\": \"2026-03-15T00:00:00Z\"\n }\n}"},{"id":"bfe5e0bc-fba5-4b88-8a20-7ef291d7a1a1","name":"200 - Dados insuficientes","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://connect.mettrix.com.br/v1/tanks/c1d2e3f4-5678-90ab-cdef-aabbccddeeff/volume-projection?projection_days=7&calculation_period_days=7","host":["https://connect.mettrix.com.br"],"path":["v1","tanks","c1d2e3f4-5678-90ab-cdef-aabbccddeeff","volume-projection"],"query":[{"key":"projection_days","value":"7"},{"key":"calculation_period_days","value":"7"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"c1d2e3f4-5678-90ab-cdef-aabbccddeeff\",\n \"name\": \"Tanque Diesel #01\",\n \"is_active\": true,\n \"volume_projection\": {\n \"projected_volume\": null,\n \"projection_days\": 7,\n \"projection_date\": null,\n \"confidence_level\": \"insufficient_data\",\n \"calculation_method\": null,\n \"daily_consumption_rate\": null,\n \"data_points_used\": 3,\n \"message\": \"Dados insuficientes para calcular projeção confiável\",\n \"notes\": \"Necessário pelo menos 7 pontos de dados no período\",\n \"will_be_empty\": false,\n \"empty_date\": null\n }\n}"}],"_postman_id":"3f111591-7562-44d6-9c36-65ec62b4c0f5"}],"id":"768ff7a5-c7ec-430f-b6d1-27e7e63df2d1","description":"Endpoint de inteligência artificial da Mettrix para projeção de volume futuro.
\nO Mettrix AI Engine utiliza o modelo Prophet ML (machine learning) para analisar padrões históricos de consumo e projetar o volume futuro do tanque.
\n