查詢單一規格
查詢單一規格
依 id 查詢單一規格。若該 id 不存在，或屬於其他租戶，一律回傳 404 not_found，兩種情況無法從回應內容區分。
Authentication
X-Signaturestring
每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。canonical string 的組成、可複製的簽章範例與 401 排查步驟，請參閱「驗證與簽章」。
Path parameters
id
要查詢的規格序號。不存在或屬於其他租戶時，一律回傳 404 not_found。
Response
OK
id
規格序號。
productId
所屬的商品序號。
outerSysCode
ERP 端的規格代碼。
name
名稱。
barcode
條碼。
warehouse
倉別。
unit
商品單位。
spec
規格內容（例如「12入」「500g」）。
price
價格。
sellPrice
賣價。
quantityPrecision
數量精度（0 為整數，1 至 4 為小數位數）。
status
規格狀態，只有兩種：Active（上架）、Inactive（下架）。與商品狀態不同，規格沒有「下架-顯示」（InactiveVisible）這個狀態——商品下架-顯示時，其規格一律收斂為 Inactive。狀態值只能在後台維護，本 API 目前不提供寫入；透過本 API 建立的規格一律為 Active。
inventoryQty
目前的在庫數量，唯讀，規格主檔的寫入端點永遠不會異動這個值。這裡是實際在庫的物理數量，不含已保留／已成立訂單的扣抵；需要可售數請改查 GET /v1/skus/{id}/stock 的 availableQty。
Errors
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error