POST接口如何传递数组？actions参数构建方法咨询

嘿，我来帮你理清楚这个问题的核心逻辑——你之前踩的坑本质上是把JSON字符串和JavaScript对象数组的概念搞混了，咱们一步步拆解：

先明确API的参数要求 #

从你给出的API请求示例可以看到，actions字段需要的是一个JSON格式的字符串，这个字符串内部是一个包含多个动作对象的数组结构。但你的postRoutine方法用了jQuery的$.ajax，这里的序列化逻辑其实能帮你省很多事。

你之前的错误原因 #

你尝试手动拼接字符串然后放进数组里，这种做法会导致传给API的actions参数变成了["{...}"]（一个包含单个字符串的数组），而API需要的是"[{...}, {...}]"（一个字符串，内部是数组），格式完全不匹配，所以肯定会失败。而且手动拼接字符串很容易出现转义符错误，非常不推荐。

正确的构建方式（两种，优先第一种） #

方式一：直接构建JS对象数组（推荐） #

就像你最后成功的做法一样，直接创建JavaScript数组，里面放动作对象即可：

// 单个动作的情况
var actions = [
  {
    "deviceId": item1.id,
    "actionName": action,
    "params": [],
    "meta": "{}"
  }
];

// 多个动作的情况，直接追加对象就行
var actions = [
  {
    "deviceId": "c39181d52abe5555",
    "actionName": "turnOff",
    "params": [],
    "meta": "{}"
  },
  {
    "deviceId": "f597c13717008fb1",
    "actionName": "armStay",
    "params": ["1234"],
    "meta": "{}"
  }
];

然后把这个数组传给postRoutine的action参数就行。这里要注意：如果你的postRoutine方法里没有设置contentType: "application/json"，jQuery默认会把data里的对象转成表单编码格式，但你最后能成功，说明API兼容了这种情况。不过更严谨的做法是修改postRoutine，明确请求体是JSON：

static postRoutine(nombre, action) { 
  return $.ajax({ 
    url: api.routines.url, 
    method: "POST", 
    dataType: "json", 
    contentType: "application/json", // 明确告诉服务器请求体是JSON
    timeout: api.timeout, 
    data: JSON.stringify({
      'name': nombre, 
      'actions': action, 
      'meta': "{}"
    }), // 手动把整个参数对象转成JSON字符串
  }) 
}

这样不管API有没有兼容其他格式，都能保证请求格式完全符合要求。

方式二：手动构建JSON字符串（不推荐，仅特殊场景用） #

如果你一定要手动处理字符串，别自己拼接，用JSON.stringify来把数组转成符合要求的JSON字符串：

var action1 = {
  "deviceId": item1.id,
  "actionName": action,
  "params": [],
  "meta": "{}"
};
var actionsStr = JSON.stringify([action1]); // 把JS数组转成JSON字符串
api.routines.postRoutine(rut_name, actionsStr).done(function(data){
  // 处理回调逻辑
});

这种方式能避免手动拼接的转义错误，但不如直接传JS数组方便，所以只在特殊情况下用。

总结一下 #

1. 优先直接构建JavaScript对象数组，简单不易出错，配合正确的AJAX配置，jQuery会帮你完成序列化。
2. 绝对不要手动拼接JSON字符串，容易出现转义错误，真要转就用JSON.stringify。
3. 确保AJAX请求设置了contentType: "application/json"，保证请求体格式和API要求一致。

内容的提问来源于stack exchange，提问作者Flama