58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
---
|
|
title: Write data with the InfluxDB API
|
|
weight: 206
|
|
description: >
|
|
Use the `/api/v2/write` InfluxDB API endpoint to write data to InfluxDB.
|
|
menu:
|
|
influxdb_v2:
|
|
name: InfluxDB API
|
|
parent: Developer tools
|
|
---
|
|
Write data to InfluxDB using an HTTP request to the InfluxDB API `/api/v2/write` endpoint.
|
|
Use the `POST` request method and include the following in your request:
|
|
|
|
| Requirement | Include by |
|
|
| :------------------ | :----------------------------------------------------------------------- |
|
|
| Organization | Use the `org` query parameter in your request URL. |
|
|
| Bucket | Use the `bucket` query parameter in your request URL. |
|
|
| Timestamp precision | Use the `precision`query parameter in your request URL. Default is `ns`. |
|
|
| API token | Use the `Authorization: Token YOUR_API_TOKEN` header. |
|
|
| Line protocol | Pass as plain text in your request body. |
|
|
|
|
#### Send a write request
|
|
|
|
The URL in the examples depends on the version and location of your InfluxDB {{< current-version >}} instance.
|
|
<a href="#" class="url-trigger">Customize URLs in examples</a>
|
|
|
|
{{< code-tabs-wrapper >}}
|
|
{{% code-tabs %}}
|
|
[Curl](#curl)
|
|
[Node.js](#nodejs)
|
|
{{% /code-tabs %}}
|
|
{{% code-tab-content %}}
|
|
```sh
|
|
{{< get-shared-text "api/v2.0/write/write.sh" >}}
|
|
```
|
|
{{% /code-tab-content %}}
|
|
{{% code-tab-content %}}
|
|
```js
|
|
{{< get-shared-text "api/v2.0/write/write.mjs" >}}
|
|
```
|
|
{{% /code-tab-content %}}
|
|
{{< /code-tabs-wrapper >}}
|
|
|
|
{{% note %}}
|
|
##### Use gzip compression with the InfluxDB API
|
|
|
|
When using the InfluxDB API `/api/v2/write` endpoint to write data, compress the data with `gzip` and set the `Content-Encoding`
|
|
header to `gzip`.
|
|
Compression reduces network bandwidth, but increases server-side load.
|
|
|
|
```sh
|
|
{{% get-shared-text "api/v2.0/write/write-compress.sh" %}}
|
|
```
|
|
{{% /note %}}
|
|
|
|
_For information about **InfluxDB API response codes**, see
|
|
[InfluxDB API Write documentation](/influxdb/v2/api/#operation/PostWrite)._
|