Listar sensores
RegistosGET /sensors
Returns a cursor-paginated page of the tenant's telemetry sensors, each with its code, device ID, metric, unit, location in the supply chain and linked asset or DMA. Page with limit and after. Requires the monitoring read permission.
Parâmetros
kindReturns only sensors of this kind: flow, pressure, level or quality.
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Devolve
200 OK
Mostrar atributos
dataMostrar atributos filhos
idcodenamedevice_idkindum de
flow,pressure,level,qualitymetricunitlocationum de
abstraction_point,treatment_plant,reservoir,distributionasset_iddma_idactive
has_morenext_cursor
Permissões business:monitoring:read · Funções: admin, analyst, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/sensors" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$BUSINESS_API/sensors", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/sensors",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/sensors", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "sen_28o3p46TDQsRdq8pzycV5cIxbMg",
"code": "COD-2026-000142",
"name": "Ana Matsinhe",
"device_id": "dev_2E2J9iiRr2o7PWMrj8wJrQyb9sK",
"kind": "flow",
"metric": "metric",
"unit": "unit",
"location": "abstraction_point",
"asset_id": "ass_2IIXBYi79uuRV0QXd685rmSLhO0",
"dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
"active": true
}
],
"has_more": true,
"next_cursor": "next cursor"
}