批量写入CSV数据
使用单个HTTP POST以CSV格式向通道写入多个条目
描述
要节省设备电源或组通道更新，可以使用批量更新API。当使用批量更新API时，您会随着时间的推移收集数据，然后将数据上传到ThingSpeak™. 要以JSON格式写入数据，请参阅批量写入JSON数据. 要编写单个条目，请参见写入数据.
笔记
如果你设定反应应用程序和测试频率着手关于数据插入，当条件类型匹配条件，即使条件多次匹配。
要求
HTTP方法
邮递
统一资源定位地址
https://api.thingspeak.com/channels/
URL参数
| 名称 | 描述 |
|---|---|
（必需）感兴趣频道的频道ID。 |
URL示例：https://api.thingspeak.com/channels/999990/bulk_update.csv
内容类型
应用程序/x-www-form-urlencoded
身体参数
| 名称 | 描述 | 值类型 |
|---|---|---|
写入api密钥 |
（必需）为此特定通道指定写入API密钥。写入API密钥位于API密钥通道视图的选项卡。 |
一串 |
时间单位格式 |
（必需）指定事件的绝对时间 |
一串 |
更新 |
要发布到通道的批量数据。用管道字符分隔连续条目( |
看见更新参数. |
更新包含要发布到频道的数据。参数在每次更新中按表中所示的顺序依次显示。每次更新中仅出现一个时间规格。
| 名称 | 描述 | 值类型 |
|---|---|---|
| 时间戳 | （必需）如果 |
日期时间或整数 |
领域 |
（必填）字段X数据，其中X是字段ID |
任何 |
| 纬度 | （必需）以度为单位的纬度，指定为介于 |
十进制的 |
| 经度 | （必需）以度为单位的经度，指定为介于 |
十进制的 |
| 高程 | （必需）标高（米） |
整数 |
| 地位 | （必需）状态字段输入的消息 | 一串 |
正文格式
每个CSV批量写入包含一个写入API键和一个时间格式规范。每个批量写入可以包含多个更新。使用管道字符分隔连续条目(|).为每个顺序参数提供数据或空白条目，直到最后一个参数具有有效数据。
write_api_key=write_api_key&time_format=time_format&Update=时间戳、FIELD1_值、FIELD2_值、FIELD3_值、FIELD4_值、FIELD5_值、FIELD6_值、FIELD7_值、FIELD8_值、纬度、经度、海拔、状态| DATETIME_戳记_或_秒数_自_最后一个_条目起，FIELD1_值、FIELD2_值、FIELD3_值、FIELD4_值、FIELD5_值、FIELD6_值、FIELD7_值、FIELD7_值、FIELD7_值D8_值、纬度、经度、高程、状态
书写api密钥=XXXXXXXXXXXXXX和时间格式=绝对和更新=2018-06-14T12:12:22-0500,1,3,0.4,1.5,1.6,1.8,40.0,5.4,0，湿| 2018-01-30T10:26:23-0500,1.2,2.3,3,4,5,6,7,8,42.0,0,0.5,50
写入api密钥=XXXXXXXXXXXXXX和时间格式=相对和更新=4,1.1,2,0.3,6,7.7,0.8,41.2,19.5100，确定| 3,1,2,3,4,5,6,7,8,41.2,25.1110，上升
局限性
单个批量更新中的消息数限制为免费帐户用户的960条消息和付费帐户用户的14400条消息。连续批量更新调用之间的时间间隔必须为15秒或更长。
MQTT订阅不会报告来自大容量写入操作的通道更新。
所有更新必须使用相同的时间格式。
所有时间戳必须是唯一的。如果您提交重复的时间戳，则会拒绝所有更新，否则仅拒绝通道中已存在时间戳的更新。
例子
创建具有相对时间戳的邮递员请求
您可以配置邮递员尝试RESTful API调用。要发送HTTP POST请求以使用CSV格式的数据批量更新频道提要，请配置POSTMAN。
从HTTP谓词的下拉列表中选择POST。
输入URL，然后更改
https://api.thingspeak.com/channels/选择x-www-form-urlencoded.
进来
写入api密钥在钥匙节，并在价值部分进来
时间单位格式在钥匙节，然后输入相对的在价值部分进来
更新在钥匙节，然后输入0,2,,,,,,,,,,,|2,2,,,,,,,,,,,|1,16,,,,,,,,,,,|2,2,,,,,,,,,,,|5,164,,,,,,,,,,,|1,22,,,,,,,,,,,|3,116,,,,,,,,,,,|在价值部分对每个空白条目使用逗号。
发送请求。
对请求的响应是一个表示成功的JSON对象。
{“成功”：真的}
图中显示了19:07:20对频道的一次调用中发布的六个值。最后一个条目具有提交请求的时间戳。具有相对时间戳的请求中的每个更新从最后一个条目开始向后递减。
使用绝对时间戳批量写入CSV值
对于具有内置实时时钟的设备，可以为每个条目提供相对时间戳。具体说明时间\格式=相对. 每个条目从上一次测量开始，以秒为单位。
POST/channels/266256/bulk_update.csv HTTP/1.1主机：api.thingspeak.com内容类型：application/x-www-form-urlencoded time_格式：relative英语常用常用常用英语英语英语英语英语英语常用常用英语英语英语常用常用英语英语英语常用英语英语常用英语英语常用英语英语常用英语英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用英语常用词汇词汇词汇10 10%3 10%3%3%3 10%3%3%3%3%3%3%3%3%3%3%3%3%3%3%3%3%3%3%3%10 10 10 10-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18-18 2C%2C%2C%2C%2C%2C%7C2018-01-31+11%3A27%3A22-0500%2C164%2C%2C%2C%2C%2C%2C%2C%2C%2C%2C%2C%2C
邮件必须是URL编码的。%2C和%7C分别表示“，”和“|”的URL编码字符。
对请求的响应是一个表示成功的JSON对象。
{“成功”：真的}
您还可以从以下列表中选择网站：
