command

Description

Accepts commands in Network API syntax over HTTP.

Supported Network API commands:

The method returns a JSON object containing the counters of failed, successful, and total commands.

Multiple Commands

Multiple commands, separated by a line feed character, can be submitted in one request in which case the commands are parsed, validated and processed sequentially.

In case of syntax errors or an out-of-range date in one of commands, the invalid command is discarded and processing continues.

The processing behavior is different from the Data Entry page, which stops processing on the first invalid command.

Request

Method Path Content-Type Header
POST /api/v1/command text/plain

Query String Parameters

Name Type Description
commit boolean Store the commands synchronously and return the response after the commands have been committed to the underlying storage.
Default: false.

Payload

List of network commands (series, metric, property, etc.), separated by line feed.

Response

Fields

{"fail":2, "success":10, "total":12}

Example

Request

URI

POST /api/v1/command

Payload

series e:DL1866 m:speed=650 m:altitude=12300
property e:abc001 t:disk k:name=sda v:size=203459 v:fs_type=nfs
series e:DL1867 m:speed=450 m:altitude=12100
message e:server001 d:2015-03-04T12:43:20+00:00 t:subject="my subject" m:"Hello, world"

Response

{"fail":0,"success":4,"total":4}

Java Example

Additional Examples

curl

curl https://atsd_hostname:8443/api/v1/command \
  --insecure --include --user collector:******** \
  --header "Content-Type: text/plain" \
  --data-binary $'series e:DL1866 m:speed=650 m:altitude=12300\nproperty e:abc001 t:disk k:name=sda v:size=203459 v:fs_type=nfs'