Chilkat Online Tools

Objective-C / Cognite API v1 / List time series

Back to Collection Items

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

CkoJsonObject *queryParams = [[CkoJsonObject alloc] init];
[queryParams UpdateInt: @"limit" value: [NSNumber numberWithInt: 100]];
[queryParams UpdateString: @"includeMetadata" value: @"true"];
[queryParams UpdateString: @"assetIds" value: @"[363848954441724, 793045462540095, 1261042166839739]"];
[queryParams UpdateString: @"rootAssetIds" value: @"[363848954441724, 793045462540095, 1261042166839739]"];

[http SetRequestHeader: @"api-key" value: @"{{api-key}}"];

CkoHttpResponse *resp = [http QuickRequestParams: @"GET" url: @"https://domain.com/api/v1/projects/{{project}}/timeseries" json: queryParams];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

NSLog(@"%d",[resp.StatusCode intValue]);
NSLog(@"%@",resp.BodyStr);

Curl Command

curl -G -d "limit=100"
	-d "includeMetadata=true"
	-d "assetIds=%5B363848954441724,%20793045462540095,%201261042166839739%5D"
	-d "rootAssetIds=%5B363848954441724,%20793045462540095,%201261042166839739%5D"
	-H "api-key: {{api-key}}"
https://domain.com/api/v1/projects/{{project}}/timeseries

Postman Collection Item JSON

{
  "id": "getTimeSeries",
  "name": "List time series",
  "request": {
    "url": {
      "host": "{{baseUrl}}",
      "path": [
        "api",
        "v1",
        "projects",
        "{{project}}",
        "timeseries"
      ],
      "query": [
        {
          "key": "limit",
          "description": "Limits the number of results to return. CDF returns a maximum of 1000 results even if you specify a higher limit.",
          "value": "100",
          "disabled": true
        },
        {
          "key": "includeMetadata",
          "description": "Whether the metadata field should be returned, or not.",
          "value": "true",
          "disabled": true
        },
        {
          "key": "cursor",
          "description": "Cursor for paging through results.",
          "disabled": true
        },
        {
          "key": "partition",
          "description": "Splits the data set into N partitions.\nYou need to follow the cursors within each partition in order to receive all the data.\nExample: 1/10\n",
          "disabled": true
        },
        {
          "key": "assetIds",
          "description": "Get the time series related to the assets. The format is a list of IDs serialized as a JSON array(int64). Takes [ 1 .. 100 ] unique items.",
          "value": "[363848954441724, 793045462540095, 1261042166839739]",
          "disabled": true
        },
        {
          "key": "rootAssetIds",
          "description": "Only include time series that have a related asset in a tree rooted at any of these root assetIds.",
          "value": "[363848954441724, 793045462540095, 1261042166839739]",
          "disabled": true
        },
        {
          "key": "externalIdPrefix",
          "description": "Filter by this (case-sensitive) prefix for the external ID.",
          "disabled": true
        }
      ],
      "variable": [
      ]
    },
    "method": "GET",
    "header": [
      {
        "key": "api-key",
        "value": "{{api-key}}",
        "description": "An admin can create API keys in the Cognite console."
      }
    ],
    "description": "List time series. Use nextCursor to paginate through the results."
  }
}