Skip to main content

Cocon Fiber Read-only API (v1)

Download OpenAPI specification:Download

License: Proprietary

The Cocon Fiber Read-only API provides several ways to request Cocon Fiber asset data.

This can be single-asset related data or aggregated information.

Access point

Get access points

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get access points by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "type": "string",
  • "stage": 0,
  • "project": "string",
  • "geolocation": {
    }
}

Building

Get buildings

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get client connections of buildings per building

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
buildingName
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "complexName": "string",
  • "frameNames": [
    ],
  • "terminationUnitTypes": [
    ],
  • "installationCompanyName": "string",
  • "cableInformation": [
    ]
}

Get buildings by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "complexId": "string",
  • "type": "string",
  • "stage": 0,
  • "geometry": {
    }
}

Get customer connections connected to a POP

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "customerConnections": [
    ]
}

Get customer locations connected to a POP Deprecated. Use `/customer-connections` instead Deprecated

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "customerConnections": [
    ]
}

Get client connections of a building by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "complexName": "string",
  • "frameNames": [
    ],
  • "terminationUnitTypes": [
    ],
  • "installationCompanyName": "string",
  • "cableInformation": [
    ]
}

Get the slacks associated with a building

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
buildingName
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Cable

Get cables

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get cables by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "endpoints": [
    ],
  • "type": "string",
  • "stage": 0,
  • "project": "string",
  • "innerducts": [
    ],
  • "capacity": 0,
  • "numberOfAvailableFibers": 0,
  • "geometry": {
    }
}

Drilling

Get drillings

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get drillings by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "type": {
    },
  • "stage": 0,
  • "project": {
    },
  • "length": 0,
  • "owner": "string",
  • "remarks": "string",
  • "geometry": {
    }
}

Get a ZIP archive containing the drilling profile for a drilling, if available

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
query Parameters
asBase64
boolean
Default: false

Responses

Response samples

Content type
application/json
{
  • "timestamp": "string",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "status": 0,
  • "errors": [
    ],
  • "message": "string"
}

Duct

Get ducts

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get ducts by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "type": "string",
  • "color": "string",
  • "diameter": 0,
  • "stage": 0,
  • "geometry": {
    },
  • "length": 0,
  • "owner": "string",
  • "innerducts": [
    ],
  • "numberOfAvailableInnerducts": 0,
  • "remarks": "string",
  • "project": "string",
  • "ductRoute": "string",
  • "locations": [
    ]
}

Enclosure

Get enclosures

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get enclosures by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "locationName": "string",
  • "name": "string",
  • "type": "string",
  • "stage": 0,
  • "project": "string",
  • "geometry": {
    }
}

Frame

Get frames

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get frames by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "locationName": "string",
  • "name": "string",
  • "type": "string",
  • "stage": 0,
  • "project": "string",
  • "geometry": {
    }
}

Permit

Get permits

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get permits by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "issuer": "string",
  • "issuerType": "string",
  • "project": "string",
  • "remarks": "string",
  • "geometry": {
    }
}

Project

Get projects

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get projects by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "description": "string",
  • "type": "string",
  • "locked": true,
  • "defaultInstallationCompany": "string",
  • "progressStatus": "string"
}

Slack

Get the slacks associated with a building

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
buildingName
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Splice tray

Get splice trays

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Patch position

Trace endpoints of a patchposition

Starts from the provided patch position and traces the network to the very end If multiple endpoints are found, it returns all of them

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
query Parameters
future
boolean
Default: false

Should the currently active network be used, or the scheduled (future) network

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Access point type

Get access point types

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get access point types by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "isAllowed": true,
  • "maximumEnclosures": 0
}

Building type

Get building types

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get building types by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "isAllowed": true
}

Cable type

Get cable types

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get cable types by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "medium": 0,
  • "layout": "string",
  • "color": "string",
  • "remarks": "string",
  • "diameter": 0,
  • "numberOfFibers": 0,
  • "isAllowed": true,
  • "numberOfTubes": 0,
  • "tubes": [
    ]
}

Duct type

Get duct types

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get duct types by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "numberOfInnerducts": 0,
  • "innerducts": [
    ],
  • "isAllowed": true
}

Enclosure type

Get enclosure types

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get enclosure types by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "isAllowed": true,
  • "maximumSpliceTrays": 0,
  • "numberOfSpliceTrayPositions": 0
}

Frame type

Get frame types

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get frame types by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "isAllowed": true,
  • "numberOfRackUnits": 0,
  • "numberingDirection": "string",
  • "numberingStartsAt": 0
}

Splice tray type

Get splice tray types

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
offset
integer <int32>
Example: offset=5

The offset of the first item returned

limit
integer <int32>
Example: limit=10

The maximum number of items returned

sort
string

A sorting hint for the returned items

filter
string

A filter specification for the returned items.

Varies for different situations. See the general API documentation for examples.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get splice tray types by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "numberOfSplicePositions": 0,
  • "heightInSpliceTrayPositions": 0,
  • "numberOfTrays": 0,
  • "isAllowed": true
}

Client connection

Get client connections of buildings per building

Authorizations:
Api-Key-HeaderClient-Id-Header
query Parameters
buildingName
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "complexName": "string",
  • "frameNames": [
    ],
  • "terminationUnitTypes": [
    ],
  • "installationCompanyName": "string",
  • "cableInformation": [
    ]
}

Get client connections of a building by id

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "complexName": "string",
  • "frameNames": [
    ],
  • "terminationUnitTypes": [
    ],
  • "installationCompanyName": "string",
  • "cableInformation": [
    ]
}

Customer connection

Get customer connections connected to a POP

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "customerConnections": [
    ]
}

Get customer locations connected to a POP Deprecated. Use `/customer-connections` instead Deprecated

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
Example: 10 or 1abc

Unique identifier

Responses

Response samples

Content type
application/json
{
  • "customerConnections": [
    ]
}

Trace endpoints

Trace endpoints of a patchposition

Starts from the provided patch position and traces the network to the very end If multiple endpoints are found, it returns all of them

Authorizations:
Api-Key-HeaderClient-Id-Header
path Parameters
id
required
string
query Parameters
future
boolean
Default: false

Should the currently active network be used, or the scheduled (future) network

Responses

Response samples

Content type
application/json
[
  • {
    }
]