Skip to content
ADP
API Design PrincipleBETA

[ADP-321] 省略空值

指導原則

  • 雖然我們定義 null 跟空值有相同語意,應該在屬性為空或為null時省略可選屬性。
  • 不得為可選屬性包含null值。
  • 應該考慮缺失屬性和明確設置為null值之間的語義差異。

範例

正確做法

json
{
  "paymentMethod": "INVOICE_SINGLE"
}

錯誤做法

json
{
  "paymentMethod": "INVOICE_SINGLE",
  "installments": null
}