Smartsheet简单POST请求写入数据失败求助

从你的描述和返回结果来看，核心问题是Smartsheet返回成功响应，但实际未写入单元格值，以下是几个排查方向和解决方案：

1. 确保请求头包含正确的Content-Type #

Smartsheet的REST API要求POST请求必须指定Content-Type: application/json，如果缺少这个头，服务器可能无法正确解析JSON payload中的value字段，导致行被创建但单元格值为空。

• Postman中：在Headers标签添加Content-Type，值设为application/json
• PowerShell中：调用Invoke-RestMethod时必须加上-ContentType 'application/json'参数

2. 验证JSON payload的完整性 #

你提供的示例payload末尾有省略号，要确保实际发送的是完全合法的JSON结构：

• 所有数组、对象的括号必须闭合（比如rows数组、cells数组的]，顶层的}）
• 最后一个cells元素后面不能有多余的逗号
• 字符串值必须用双引号包裹（不能用单引号）

正确的完整payload示例：

{
  "toTop": true,
  "rows": [
    {
      "cells": [
        {
          "columnId": 726263711092612,
          "value": "data"
        },
        {
          "columnId": 5229863338463108,
          "value": "more data"
        },
        {
          "columnId": 2978063524777860,
          "value": "even more data"
        }
      ]
    }
  ]
}

3. 检查视图过滤条件 #

Smartsheet的视图可能设置了过滤规则，导致新插入的行被隐藏。你可以：

• 切换到表格的默认视图（无过滤）查看
• 检查当前视图的过滤设置，确认是否排除了新插入的行数据

4. 验证主键列的配置 #

你的第一列是主键列，需确认：

• 主键列是否设置为自动编号：如果是，不需要在payload中传value，手动传入的值会被忽略
• 主键值是否唯一：如果传入的value已存在于表格中，Smartsheet可能不会报错，但会导致行无法正常显示

可用的PowerShell请求示例 #

以下是完整的PowerShell命令模板，确保包含所有必要参数：

$sheetId = "你的表格ID"
$apiToken = "你的API令牌"
$payload = @"
{
  "toTop": true,
  "rows": [
    {
      "cells": [
        {
          "columnId": 726263711092612,
          "value": "data"
        },
        {
          "columnId": 5229863338463108,
          "value": "more data"
        },
        {
          "columnId": 2978063524777860,
          "value": "even more data"
        }
      ]
    }
  ]
}
"@

Invoke-RestMethod -Uri "https://api.smartsheet.com/2.0/sheets/$sheetId/rows" `
  -Method Post `
  -Headers @{"Authorization" = "Bearer $apiToken"} `
  -ContentType "application/json" `
  -Body $payload

另外，不需要必须使用SDK，直接调用REST API完全可行，问题大多出在请求细节的遗漏上。

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