查詢規格價格

View as Markdown

依規格序號查詢目前的牌價與對外售價。id 不存在、屬於其他租戶,或指向組合商品(Bundle)的規格時,一律回傳 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

idlongRequired

要查詢價格的規格序號。不存在、屬於其他租戶,或指向組合商品(Bundle)的規格時,一律回傳 404 not_found。

Response

OK
pricedouble or nullOptional

牌價。

sellPricedouble or nullOptional

對外售價。

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error