商品を1件取得する
必要なスコープ: products:read。
GET
/products/{product_id}認証
AuthorizationBearer トークン · header必須管理画面または CLI の cozeni login で発行したクリエイターAPIキー。購入者認証には使わない。
パスパラメーター
product_idstring必須最小長 1 · 最大長 200
レスポンス
200
公開商品情報。リンクは別APIで取得する。
idstring必須namestring必須price_jpyinteger必須currencystring必須許可される値:
jpyrecurring_intervalstring | null必須支払いタイプ。null(省略)は買い切り、month は月額、year は年額のサブスク。作成後は変えられない。
許可される値:
monthyearnulltrial_intervalstring | null必須無料トライアルの期間の単位。trial_interval_count と両方そろえる。null(両方)でトライアルなし。定期の商品だけ。
許可される値:
dayweekmonthyearnulltrial_interval_countinteger | null必須無料トライアルの期間の長さ。上限は単位ごと(day 730・week 104・month 24・year 2)。
最小 1 · 最大 730
access_urlstring | null必須access_typestring必須許可される値:
pagefeaturefilemetadataExternalFeatureFlagMetadata必須機能フラグの設定値。50件まで。キーは1〜40字の英数字・_・-(proto は不可)。値は文字列(1〜500字)・数値・真偽値。URLやAPIキーなどの秘匿情報は入れない。
descriptionstring | null必須imagesExternalProductImage[]必須プロパティを表示プロパティを非表示
ExternalProductImage の配列idstring必須urlstring<uri>必須content_typestring必須size_bytesinteger必須statusstring必須許可される値:
activearchivedcreated_atstring<date-time>必須updated_atstring<date-time>必須400
invalid_input。未知フィールド、無効なcursor・入力を含む。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須401
unauthorized。失効、期限切れ、環境違いを含む。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須403
insufficient_scope。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須404
product_not_found / checkout_link_not_found。他人の商品も404。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須409
idempotency_conflict / product_archived / checkout_link_disabled。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須429
rate_limited。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須500
internal。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須503
unavailable。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須