字串型別：string 與 text

用途

string 適合 SKU、Email、短標題等單行文字；text 適合客服備註、產品說明與會議紀錄等長文。例如訂單表可用 string 儲存「KB-87」SKU，再用 text 保存「客戶要求週五前到貨」的完整交付備註。

建立 schema

以下都是 columns.create 的 body。短字串通常搭配 max_length：

{
  "name": "SKU",
  "type": "string",
  "required": true,
  "max_length": 40,
  "description": "倉儲商品代碼"
}

長文仍可選擇設定長度上限：

{
  "name": "客服備註",
  "type": "text",
  "required": false,
  "max_length": 2000,
  "description": "客服與物流交接資訊"
}

合法與不合法的值

合法值是 JSON 字串；選填欄也可以是 null 或空字串。

{
  "data": {
    "SKU": "KB-87",
    "客服備註": "客戶要求週五前到貨"
  }
}

以下兩種寫法會被拒：SKU 不是字串，而備註超過已設定的 max_length。

{
  "data": {
    "SKU": 87,
    "客服備註": "這段文字的實際長度超過欄位設定的上限"
  }
}

伺服器錯誤會指出 must be a string 或 exceeds maximum length of 2000；完整紀錄請求見 records.create。

顯示與回傳

兩種型別都以原始 JSON 字串回傳，不會加入 Markdown、HTML 或換行轉換。紀錄回應的 data 使用顯示名稱作為 key：

{
  "data": {
    "SKU": "KB-87",
    "客服備註": "客戶要求週五前到貨"
  }
}

前端通常把 string 放進單行輸入框，把 text 放進多行文字區；API 的 cell 形狀則完全相同。

注意事項

• max_length 只適用於 string 與 text；其他型別不應帶這個欄位。
• 選填欄的 null 與空字串都視為空值；required: true 時，建立紀錄送空值會被拒。
• 更新必填欄時可以省略該 key，代表不變；若明確送 null 或空字串，伺服器會拒絕清空。
• 在已有紀錄的表新增必填欄時，必須提供 default_value，讓舊紀錄能完成遷移。

試試看

到 API Playground 選擇 columns.create，先建立短字串，再用 records.create 驗證長度限制。