布林型別：boolean

用途

boolean 表達只有真與假的狀態，例如「已付款」、「啟用中」或「需要人工覆核」。在商品表中，是否上架 可以直接驅動開關控制項，避免用 "yes"、"Y" 與 1 混出多套語意。

建立 schema

columns.create body 必須使用真正的 JSON 布林值作為預設值：

{
  "name": "是否上架",
  "type": "boolean",
  "required": true,
  "default_value": false,
  "description": "商品是否可在前台販售"
}

合法與不合法的值

非空的合法值只有 true、false。選填欄也接受 null 或空字串作為空值，整合端建議固定送 null。

{
  "data": {
    "是否上架": true
  }
}

字串與數字不會自動轉成布林值：

{
  "data": {
    "是否上架": "true"
  }
}

{
  "data": {
    "是否上架": 1
  }
}

兩者都會收到 must be a boolean。

顯示與回傳

API 回傳原生 JSON 布林值，不會回傳 "true" 字串：

{
  "data": {
    "是否上架": false
  }
}

前端可顯示 checkbox 或 switch；如果欄位不是必填，請保留 null、false、true 三種狀態，不要把未設定強制折成 false。

注意事項

• false 是有效值，不是缺值；用明確的 null 表示未設定。
• 字串 "false" 在 JavaScript 條件判斷中仍為 truthy，但後端會拒絕它；送出前請維持原生布林型別。
• integer 與 float 也會明確拒絕布林值，不會把它當成 0 或 1。
• 必填布林欄在已有紀錄的表新增時，應提供 default_value 以完成舊資料遷移。

試試看

到 API Playground 建立布林欄，再用 records.create 比較 false、null 與字串 "false"。