Batch Service

Please read the web service primer to understand how to provide proper authentication parameters. For simplicity, authentication parameters are not shown here.

A highly efficient service for loading many values at once in a single post. Accepts up to 100 new values for points in one post. Simply provide a parameter with an incrementing number for each new value to record. For example, p1=FirstPoint&v1=1.23&p2=SecondPoint&v2=3.14.

This will save the value 1.23 into a point called FirstPoint, and 3.14 into SecondPoint. Both will get the current time as a timestamp.

You can include a timestamp and nimbits will record your value with the stamp you provide. You can also give the same point with many timestamped values, or mix and match. i.e p1=FirstPoint&v1=1.23&t1=1297655407000&p2=FirstPoint=3.14&t2=1297655408000

This will record the two values into FirstPoint with different timestamps.

Heads up! There is a new option for loading the batch service using JSON data containing an array of Value Objects

• p(x) - the name of the point
• v(x) - the new value belonging to p1.
• t(x) - optional - the timestamp as a long, unix epoch time in milliseconds. Can also be in scientific notation i.e 1.3190148e+12
• lt(x) - optional - the latitude of the reading
• ln(x) - optional - the longitude of the reading
• dx(x) - optional - raw string data to be recorded (i.e json or xml)
• j(x) - optional - an array of JSON formatted Value Objects.
  Please Note: using this option will override any other parameters set from the list above. This also is a highly efficient way to slam new data into a point and therefore, compression filters, alerts and other point settings are not processed when data is fed in. The system assumes you have already formatted / filtered your incoming data the way you want it. So, the new data goes directly into the store. Read the Value Objects document for samples of a value json structure

Sample - records multiple values up to p100 and v100

        /service/batch?p1=point1&v1=2.3&p2=point2&v2=3.24....

        /service/batch?p1=point1&v1=2.3&t1=1297655407000&p2=point2&v2=3.24....

 

JSON Bulk Sample

    /service/batch?p1=point1&j1=[
    {"lt":0.0,"lg":0.0,"d":0.2,"t":1342373434789,"n":"","dx":""},
    {"lt":0.0,"lg":0.0,"d":0.3,"t":1342373374789,"n":"","dx":""},
    {"lt":0.0,"lg":0.0,"d":0.4,"t":1342373314789,"n":"","dx":""},
    {"lt":0.0,"lg":0.0,"d":0.5,"t":1342373254789,"n":"","dx":""},
    {"lt":0.0,"lg":0.0,"d":0.1,"t":1342373194789,"n":"","dx":""},
    {"lt":0.0,"lg":0.0,"d":0.2,"t":1342373134789,"n":"","dx":""}]