Locate a property connected to a splitter port
- Leonardo Brandão
The following describes the process to locate a property connected to a Splitter port based on the available information from the Splitter itself.
Process steps
Identify the splitter ports and obtain the fiber connected to the port
Identify which Splitter ports are connected by checking theconnectables.outputfield.Retrieve the fiber connected to the port
Using the ID of the fiber connected to the Splitter port, retrieve its data.Obtain cable data from the fiber
Using theparentfield of the fiber, identify the cable responsible for the connection.Retrieve property details
Using the property ID obtained from the cable information, retrieve the property data.
Example
In this example will be used the following Splitter data:
{
"isBalanced": true,
"orientation": "right",
"label": "",
"attenuation": [
10.5,
10.5,
10.5,
10.5,
10.5,
10.5,
10.5,
10.5
],
"implanted": true,
"isDrop": true,
"kind": "Splitter",
"parent": "67100ab7f7c87615f2b9386f",
"project": "662f84e9e736c00021effccd",
"name": "Splitter 1",
"splitterType": "5da61085493d9c00066653f5",
"connectables": {
"input": [
null
],
"output": [
null,
"67126f35f7c87615f2b951b0",
null,
null,
null,
null,
null,
null
],
"id": "677ff4f2de2d97f28054edbb"
},
"ratio": {
"output": 8,
"input": 1,
"id": "677ff4f2de2d97f28054edd3"
},
"size": 1,
"id": "67100ab7f7c87615f2b93874"
...
}
Identify the Splitter Ports and Obtain the Fiber Connected to Each Port
The Splitter data includes a connectables property that specifies its input and output connections. The output field represents the Splitter's output ports, which in this case include 8 ports.
A port with a
nullvalue indicates no connection.A port with a value displays the ID of the connected fiber.
In this example, port 2 has a connection with the fiber ID 67126f35f7c87615f2b951b0.
Retrieve the fiber connected to the port
To fetch the details of the fiber with ID 67126f35f7c87615f2b951b0, use the following request to the fibers endpoint:
curl --location 'https://exemplo.ozmap.com.br:9994/api/v2/fibers/67126f35f7c87615f2b951b0' \
--header 'Authorization: OZMAP_KEY'The expected response is:
{
"isDrop": true,
"connectors": [
"67100ab7f7c87615f2b93874"
],
"kind": "Fiber",
"name": "L1-F1",
"parent": "67126f35f7c87615f2b951af",
"project": "662f84e9e736c00021effccd",
"fiberNumber": 1,
"createdAt": "2024-10-18T14:22:45.579Z",
"updatedAt": "2024-10-18T14:22:45.782Z",
"id": "67126f35f7c87615f2b951b0"
}The parent property indicates the ID 67126f35f7c87615f2b951af, which corresponds to the cable of this fiber.
Obtain cable data from the fiber
To retrieve the details of the cable with ID 67126f35f7c87615f2b951af, use the following request to the cables endpoint:
The expected response is:
The boxA and boxB properties indicate the elements connected to the cable:
boxArepresents the box where the Splitter is located.boxBcorresponds to the property connected to the port.
The ID 67126f35f7c87615f2b951ad in boxB refers to the property connected to port 2 of the Splitter.
Retrieve property details
To fetch the property details for ID 67126f35f7c87615f2b951ad, use the following request to the properties endpoint:
The expected response is: