Listar troços
RegistosGET /topology/links
Lists the directed links (pipes, mains and valves) of the tenant's network topology, newest first, with cursor pagination (limit defaults to 20, maximum 100). Filters combine with AND, and an unknown filter value returns an empty page rather than an error. Requires network read access.
Parâmetros
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
node_idMatches either endpoint
link_typeReturns only links of this type: gravity_main, pumping_main, distribution_pipe or control_valve.
um de
gravity_main,pumping_main,distribution_pipe,control_valvestatusReturns only links in this operating state: open, closed or throttled.
um de
open,closed,throttled
Devolve
200 Links
Mostrar atributos
dataMostrar atributos filhos
idtenant_idlink_codefrom_node_idto_node_idlink_typeum de
gravity_main,pumping_main,distribution_pipe,control_valvelength_metersdiameter_mmroughness_coefficientHazen-Williams C
statusum de
open,closed,throttledasset_idcreated_atupdated_at
has_morenext_cursor
Permissões network:read · Funções: admin, analyst, field_reader, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/topology/links" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$BUSINESS_API/topology/links", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/topology/links",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/topology/links", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "top_26ATL6Y7Pm2ppeMTl60jhySNHae",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"link_code": "LIN-2026-000142",
"from_node_id": "fro_2b3GWtBsQPTMCF5SOjDUUp7QKHr",
"to_node_id": "ton_2qKn74u1zmYRZmiRFqqbFqoplME",
"link_type": "gravity_main",
"length_meters": 1,
"diameter_mm": 1,
"roughness_coefficient": 1,
"status": "open",
"asset_id": "ass_2IIXBYi79uuRV0QXd685rmSLhO0",
"created_at": "2026-11-19T09:30:00Z",
"updated_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}