- Print
- DarkLight
- PDF
Operation is used to get a list of Cables. Available from product version 3.2.6.
Cables can be filtered by giving filtering parameters at HTTP querystring (see parameters).
Token issued for API consumer.
Offset to start returning results.
Limit number of results returned. Set to -1 to use maximum limit set in the environment. Default limit will be used if parameter is not specified. Special value -1 is available from product version 3.2.18.
Coordinate system to transform location to.
Example: srs=epsg:4326
Filters list by selected object field value. Supports structured queries via +__+ delimiter. Supports ending keywords via +__+ delimiter:
- For string fields: istartswith, startswith, iendswith, endswith, contains, icontains, isnull
- For numerics: gt, lt, gte, lte, isnull
- For spatial fields: contains, isnull, within, intersects, disjoint, touches, overlaps, covers, coveredby Examples:
+++usage_state__txt__istartswith=in+++
,+++plan__state__txt__startswith=In+++
,+++creation_date__gte=2019-01-02T15:32:01+++
,+++location__within=POLYGON ((641503.89 6944059.81, 641406.52 6943933.87, 641369.48 6943772.48, 641474.25 6943704.74, 641873.78 6943735.96, 641848.38 6943975.15, 641607.08 6944167.76, 641653.11 6944102.15, 641503.89 6944059.81))+++
Supports exclusive queries by field value using a not-operator preceeding the field lookup: Examples:+++not__type__txt__istartswith=Tie+++
,+++not__id=1390+++
Selects the object field to order the returned objects by. Can be used to sort in reverse order with '-' prefix. Can have several ordering rules separated by comma. Can be used only for object own fields and does not supports structured queries. Example: orderby=creator,-creation_date
A result response object.
{
"automSecLengthCalc": null,
"batch": "",
"cableId": "",
"cableType": {
"attenuation": null,
"availabilityEnd": null,
"availabilityStart": null,
"colorCoding": null,
"colorConfig": null,
"cuCapacity": 20,
"defInstallation": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_TYPE",
"id": 961,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_TYPE/",
"logical_txt": "Ilma",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Aerial"
},
"diameter": null,
"fiThreads": 0,
"id": 3610,
"listUrl": "http://example.keycom.fi/api/v2/cabletype/",
"resistance": null,
"technology": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_TECHNOLOGY",
"id": 10,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_TECHNOLOGY/",
"logical_txt": "Kupari",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Copper"
},
"type": "VMOHBUK 20*2*0.5",
"unitCost": null
},
"connectedCapacity": 4,
"connections": [
{
"cableDirection": "B",
"manhole": null,
"premises": {
"id": 73010,
"listUrl": "http://example.keycom.fi/api/v2/premises/",
"name": "KAAPPI",
"type": {
"cost": null,
"id": 801,
"listUrl": "http://example.keycom.fi/api/v2/premtypes/",
"manufacturer": "Tuntematon",
"productCode": "",
"type": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "PREM_TYPE",
"id": 401,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/PREM_TYPE/",
"logical_txt": "Jakamo",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Telecom premise"
}
}
},
"splice": null
},
{
"cableDirection": "E",
"manhole": null,
"premises": {
"id": 73030,
"listUrl": "http://example.keycom.fi/api/v2/premises/",
"name": "PÄÄTE SARV.LINNA",
"type": {
"cost": null,
"id": 1001,
"listUrl": "http://example.keycom.fi/api/v2/premtypes/",
"manufacturer": "Tuntematon",
"productCode": "",
"type": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "PREM_TYPE",
"id": 1721,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/PREM_TYPE/",
"logical_txt": "Pylväspääte",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Pole terminal"
}
}
},
"splice": null
}
],
"createdBy": "",
"createdTs": null,
"endReading": null,
"extraLength": null,
"falseCable": false,
"freeCapacity": 2,
"heightAccuracy": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "H_ACCURACY",
"id": 117210,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/H_ACCURACY/",
"logical_txt": "Ei määritelty",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Not defined"
},
"historyDate": null,
"id": 108030,
"identification": "108030",
"importance": null,
"installYear": 0,
"installationType": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_TYPE",
"id": 961,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_TYPE/",
"logical_txt": "Ilma",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Aerial"
},
"length": 987.3,
"location": "LINESTRING Z (453950.3968999999924563 6702355.8256999999284744 0.0000000000000000, 453906.3121999999857508 6702314.9418999999761581 0.0000000000000000, 453882.1871999999857508 6702293.8472999995574355 0.0000000000000000, 453840.5094999999855645 6702261.6430000001564622 0.0000000000000000, 453799.4174999999813735 6702227.8823999995365739 0.0000000000000000, 453759.3870999999926426 6702197.4374000001698732 0.0000000000000000, 453721.3789000000106171 6702164.1966000003740191 0.0000000000000000, 453681.9722000000183471 6702132.7240000003948808 0.0000000000000000, 453650.0884000000078231 6702108.3876000000163913 0.0000000000000000, 453614.8120999999810010 6702079.4940999997779727 0.0000000000000000, 453581.6897999999928288 6702053.2345000002533197 0.0000000000000000, 453554.9898999999859370 6702024.1650000000372529 0.0000000000000000, 453519.5375999999814667 6701999.7505999999120831 0.0000000000000000, 453478.0347000000183471 6701972.6952999997884035 0.0000000000000000, 453443.6049999999813735 6701951.0467999996617436 0.0000000000000000, 453400.0459000000264496 6701926.4113999996334314 0.0000000000000000, 453372.2803999999887310 6701907.8296999996528029 0.0000000000000000, 453334.5289999999804422 6701883.0614999998360872 0.0000000000000000, 453282.7420000000274740 6701892.8850999996066093 0.0000000000000000, 453214.3585999999777414 6701906.2022000001743436 0.0000000000000000, 453163.1503999999840744 6701916.6575999995693564 0.0000000000000000, 453156.6243000000249594 6701883.6019000001251698 0.0000000000000000)",
"locationAccuracy": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_LOC_ACCURACY",
"id": 8021,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_LOC_ACCURACY/",
"logical_txt": "2.0m",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "2.0m"
},
"mapper": "",
"mappingMethod": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "MAPPING_METHOD",
"id": 390,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/MAPPING_METHOD/",
"logical_txt": "Digitoitu",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Digitized"
},
"measure": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_MEASURE",
"id": 9221,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_MEASURE/",
"logical_txt": "From map",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "From map"
},
"owner": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_OWNER",
"id": 4441,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_OWNER/",
"logical_txt": "Loviisan Puhelin",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Loviisan Puhelin"
},
"plan": null,
"remarks": "",
"rentPaid": null,
"renter": null,
"role": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_ROLE",
"id": 266310,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_ROLE/",
"logical_txt": "Tilaajakaapeli",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "Subscriber Drop cable"
},
"secondaryLength": null,
"startReading": null,
"state": {
"availability_end_ts": "2020-12-31",
"availability_start_ts": "2020-01-01",
"available": true,
"groupname": "CABLE_STATE",
"id": 290,
"list_url": "http://example.keycom.fi/api/v2/txt_constants/groupname/CABLE_STATE/",
"logical_txt": "Original",
"num_value": 10.1,
"num_value2": 20.2,
"num_value3": 30.3,
"num_value4": 40.4,
"txt": "In use"
},
"supercable": null,
"supercableOrderno": null,
"surveyAmount": "",
"telecomArea": null,
"totalCapacity": 20,
"totalLength": 987.3,
"updatedBy": "KEYCOM_STAGE",
"updatedTs": "2010-07-22T10:53:42Z",
"usedCapacity": 2
}
Url to next page of Cables. Null if No next page exist
Url to previous page of Cables. Null if No previous page exist
List of fetched Cables
Automatic secondary length calculation
Cable batch
Cable ID
Cable type
Attenuation (dB/km)
Availability end
Availability start
Color coding
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Color config coding type
Description
Maximum number of threads
Name
Copper capacity
Default installation
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Diameter (mm)
Fiber threads
Primary key
Url to fetch all cable types
Resistance
Cable type technology
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Cable type
Unit cost
Connected capacity. This field can not be used for filtering results in searches. Available from product version 3.2.12.
List of cable's connection objects
An object representing a connection between cable and another object.
Describes which end the connection exists on. Either Beginning or End.
Minified information of a telecom manhole object
Manhole primary key
Name of manhole
Manhole type
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Minified information of a telecom premises object
Premises primary key
Name of premises
Premises identification
Premises type
Primary key
Url to fetch all objects
Premises manufacturer
Product code
Premises type type
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Url to full information of premises object
Minified information of a telecom splice object
Splice primary key
Splice number
Splice type
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Creator
Creation date time
End reading
Extra length
Is cable a false cable
Free capacity. This field can not be used for filtering results in searches. Available from product version 3.2.12.
Height accuracy
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Mapping date
Primary key
Cable importance
Install year
Default installation
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Cable laying state
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Cable length
Geographical location
Cable location accuracy
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Mapper
Mapping method
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Cable or conduit measure
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value,
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Is cable geometry altered to connected conduits. Available from 3.2.16 on demand.
Cable owner
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Url to fetch details of related plan.
Is rent paid
Cable owner
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Cable role
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Safety Distance
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant.
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Secondary length
Start reading
Cable state
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Url to fetch details of supercable.
Specifies supercable order
Survey amount
Telecom area id
Total capacity
Total length
Last updater
Last update date time
Used capacity. This field can not be used for filtering results in searches. Available from product version 3.2.12.
Total number of Cables
Authentication credentials are missing or invalid
{
"details": "Authentication credentials were not provided"
}
Detailed description of error