Data storage example - Revision history

KKoPV: /* Default */

2014-09-28T15:30:42Z

‎Default

KKoPV at 21:23, 30 August 2014

2014-08-30T21:23:13Z

KKoPV at 21:22, 30 August 2014

2014-08-30T21:22:05Z

KKoPV at 08:52, 27 August 2014

2014-08-27T08:52:52Z

KKoPV: /* Insert data */

2014-08-27T08:51:45Z

‎Insert data

KKoPV: /* Insert data */

2014-08-27T08:51:03Z

‎Insert data

KKoPV: /* Insert data */

2014-08-27T08:49:13Z

‎Insert data

KKoPV: Created page with "== Data == As example we will store a temperature. {| class="wikitable" |- ! Parameter !! Value !! since |- | API key || a10d3cca-370c-121e-b79c-2f0a58030a01 || `r1` ..."

2014-02-27T13:03:40Z

Created page with "== Data == As example we will store a temperature. {| class="wikitable" |- ! Parameter !! Value !! since |- | API key || a10d3cca-370c-121e-b79c-2f0a58030a01 || <tt>r1</tt> ..."

New page

== Data ==

As example we will store a temperature.

{| class="wikitable"
|-
! Parameter !! Value !! since
|-
| API key || a10d3cca-370c-121e-b79c-2f0a58030a01 || <tt>r1</tt>
|-
| Channel GUID || 87fd-cc15-cb33-71a8-6b78-3855-4c11-a79e || <tt>r1</tt>
|-
| Temperature || 23.45 °C || <tt>r1</tt>
|}

== Insert data ==

To store data we send a <tt>PUT</tt> request from a console with [[Wikipedia:curl]].

The API key must be send as a Header field named <tt>X-PVLng-key</tt>

Interesting is the HTTP code returned and the response body for error analysis in case of HTTP code is not 200 or 201.

$ set $(curl --request PUT \
–-write-out %{http_code} \
--output /tmp/pvlng.curl \
--header "X-PVLng-key: a10d3cca-370c-121e-b79c-2f0a58030a01" \
--data data=23.45 \
<nowiki>http://your.domain.here/api/r3/data/87fd-cc15-cb33-71a8-6b78-3855-4c11-a79e.txt</nowiki>)

To get readable error messages back, request content type text/plain (triggered by file extension <tt>.txt</tt>).

== Simple check ==

$ test $1 -eq 200 -o $1 -eq 201 || echo "Error ($1): $(</tmp/pvlng.curl)" && exit 1

[[Category:Example]]

← Older revision		Revision as of 15:30, 28 September 2014
Line 1:		Line 1:
	[[Category:Example]]		[[Category:Example]]
		+	[[Category:API]]
	== Default ==		== Default ==

@@ Line 26: / Line 26: @@
           --header "X-PVLng-key: a10d3cca-370c-121e-b79c-2f0a58030a01" \
           --data-binary {"data":"23.45"} \
-          <nowiki>http://your.domain.here/api/r3/data/87fd-cc15-cb33-71a8-6b78-3855-4c11-a79e.txt</nowiki>)
+          <nowiki>http://your.domain.here/api/r4/data/87fd-cc15-cb33-71a8-6b78-3855-4c11-a79e.txt</nowiki>)
 To get readable error messages back, request content type text/plain (triggered by file extension <tt>.txt</tt>).
@@ Line 52: / Line 52: @@
           --header "X-PVLng-key: a10d3cca-370c-121e-b79c-2f0a58030a01" \
           --data-binary {"data":"23.45","timestamp":"1409436671"} \
-          <nowiki>http://your.domain.here/api/r3/data/87fd-cc15-cb33-71a8-6b78-3855-4c11-a79e.txt</nowiki>)
+          <nowiki>http://your.domain.here/api/r4/data/87fd-cc15-cb33-71a8-6b78-3855-4c11-a79e.txt</nowiki>)

@@ Line 1: / Line 1: @@
 [[Category:Example]]
 As example we will store a temperature.
@@ Line 13: / Line 15: @@
 |}
-To store data we send a <tt>PUT</tt> request from a console with [[Wikipedia:curl|curl]].
+* We have to make a PUT request with JSON encoded body content: <tt>{"data":"<value>"}</tt> from a console with [[Wikipedia:curl|curl]].
+* The API key must be send as a Header field named <tt>X-PVLng-key</tt>
-The API key must be send as a Header field named <tt>X-PVLng-key</tt>
+* Here only the measuring data is send, the timestamp will be used from server.
 Interesting is the HTTP code returned and the response body for error analysis in case of HTTP code is not 200 or 201.
@@ Line 31: / Line 33: @@
   $ test $1 -eq 200 -o $1 -eq 201 || echo "Error ($1): $(</tmp/pvlng.curl)" && exit 1

@@ Line 16: / Line 16: @@
 == Insert data ==
-To store data we send a <tt>PUT</tt> request from a console with [[Wikipedia:curl]].
+To store data we send a <tt>PUT</tt> request from a console with [[Wikipedia:curl|curl]].
 The API key must be send as a Header field named <tt>X-PVLng-key</tt>

Data storage example - Revision history

KKoPV: /* Default */

KKoPV at 21:23, 30 August 2014

KKoPV at 21:22, 30 August 2014

KKoPV at 08:52, 27 August 2014

KKoPV: /* Insert data */

KKoPV: /* Insert data */

KKoPV: /* Insert data */

KKoPV: Created page with "== Data == As example we will store a temperature. {| class="wikitable" |- ! Parameter !! Value !! since |- | API key || a10d3cca-370c-121e-b79c-2f0a58030a01 || r1 ..."

KKoPV: Created page with "== Data == As example we will store a temperature. {| class="wikitable" |- ! Parameter !! Value !! since |- | API key || a10d3cca-370c-121e-b79c-2f0a58030a01 || `r1` ..."