Get list of Supercables
  • 28 Oct 2024
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Get list of Supercables

  • Dark
    Light
  • PDF

Article summary

Get
/supercables/

Operation is used to get a list of Supercables. Available from product version 3.2.6.

Supercables can be filtered by giving filtering parameters at HTTP querystring (see parameters).

Security
API Key
Header parameter nameAuthorization

Token issued for API consumer.

Query parameters
offset
integer

Offset to start returning results.

Minimum0
limit
integer

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.

Minimum1
__any of the object fields__
string

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+++
orderby
string

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

Responses
200

A result response object.

{
  "createdBy": "test.account@keypro.fi",
  "createdTs": "2018-04-11T01:14:23Z",
  "id": 9635610,
  "label": "",
  "name": "New supercable",
  "updatedBy": "test.account@keypro.fi",
  "updatedTs": "2018-04-11T01:14:23Z"
}
Expand All
object
Next
string (url)

Url to next page of Supercables. Null if No next page exist

Prev
string (url)

Url to previous page of Supercables. Null if No previous page exist

Results
Array of object (Supercable)

List of fetched Supercables

object

Cable type

createdBy
string

Creator

createdTs
string (date-time)

Creation date time

id
integer

Primary key

label
string

Supercable label

listUrl
string

Url to fetch all cable types

name
string

Supercable name

updatedBy
string

Last updater

updatedTs
string (date-time)

Last update date time

Total
integer

Total number of Supercables

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}
object
details
string

Detailed description of error


Was this article helpful?