Documentation

http.post() function

The http.post() function submits an HTTP POST request to the specified URL with headers and data and returns the HTTP status code.

Function type: Output

import "http"

http.post(
  url: "http://localhost:8086/",
  headers: {x:"a", y:"b", z:"c"},
  data: bytes(v: "body")
)

Parameters

url

The URL to POST to.

Data type: String

headers

Headers to include with the POST request.

Data type: Record

Header keys with special characters

Wrap header keys that contain special characters in double quotes ("").

{"key-1": "value 1", "key#2": "value 2" }

data

The data body to include with the POST request.

Data type: Bytes

Examples

Send the last reported status to a URL
import "json"
import "http"

lastReported =
  from(bucket: "example-bucket")
    |> range(start: -1m)
    |> filter(fn: (r) => r._measurement == "statuses")
    |> last()
    |> findColumn(fn: (key) => true, column: "_level")

http.post(
  url: "http://myawsomeurl.com/api/notify",
  headers: {
    Authorization: "Bearer mySuPerSecRetTokEn",
    "Content-type": "application/json"
  },
  data: json.encode(v: lastReported[0])
)

New! Cloud or OSS?

InfluxDB OSS 2.0 now generally available!

InfluxDB OSS 2.0 is now generally available and ready for production use. See the InfluxDB OSS 2.0 release notes.

For information about upgrading to InfluxDB OSS 2.0, see: