sayren Docs
상품

상품 상세 조회

GET
/v1/products/{productId}

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Path Parameters

productId*string

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X GET 'https://api.sayren.io/v1/products/string' \  -H 'X-Store-Id: string'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "productId": "prod_3f9a1c2b7d4e",    "productNo": 482,    "name": "오버핏 코튼 반팔 티셔츠",    "status": "SALE",    "salePrice": 29000,    "discountedPrice": null,    "stockQuantity": 145,    "categoryId": "cat_tshirt",    "thumbnailUrl": "https://cdn.avarlabs.com/demo/tshirt-white.jpg",    "hasOptions": true,    "updatedAt": "2026-09-24T10:30:00+09:00",    "createdAt": "2026-09-24T10:30:00+09:00",    "description": "<p>도톰한 20수 코튼으로 만든 오버핏 반팔 티셔츠입니다.</p>",    "descriptionJson": null,    "originalPrice": 39000,    "images": [      "https://cdn.avarlabs.com/demo/tshirt-white.jpg"    ],    "attributes": [],    "optionGroups": [      {        "groupId": "og_color",        "name": "색상",        "sortOrder": 0,        "values": [          {            "valueId": "ov_white",            "name": "화이트",            "sortOrder": 0          },          {            "valueId": "ov_black",            "name": "블랙",            "sortOrder": 1          }        ]      },      {        "groupId": "og_size",        "name": "사이즈",        "sortOrder": 1,        "values": [          {            "valueId": "ov_m",            "name": "M",            "sortOrder": 0          },          {            "valueId": "ov_l",            "name": "L",            "sortOrder": 1          }        ]      }    ],    "variants": [      {        "variantId": "var_white_m",        "variantNo": "482-01",        "valueIds": [          "ov_white",          "ov_m"        ],        "name": "화이트 / M",        "additionalPrice": 0,        "stockQuantity": 50,        "sku": null,        "barcode": null,        "costPrice": null,        "weightGram": null,        "sellerCode": null,        "usable": true      },      {        "variantId": "var_white_l",        "variantNo": "482-02",        "valueIds": [          "ov_white",          "ov_l"        ],        "name": "화이트 / L",        "additionalPrice": 0,        "stockQuantity": 40,        "sku": null,        "barcode": null,        "costPrice": null,        "weightGram": null,        "sellerCode": null,        "usable": true      },      {        "variantId": "var_black_m",        "variantNo": "482-03",        "valueIds": [          "ov_black",          "ov_m"        ],        "name": "블랙 / M",        "additionalPrice": 0,        "stockQuantity": 35,        "sku": null,        "barcode": null,        "costPrice": null,        "weightGram": null,        "sellerCode": null,        "usable": true      },      {        "variantId": "var_black_l",        "variantNo": "482-04",        "valueIds": [          "ov_black",          "ov_l"        ],        "name": "블랙 / L",        "additionalPrice": 1000,        "stockQuantity": 20,        "sku": null,        "barcode": null,        "costPrice": null,        "weightGram": null,        "sellerCode": null,        "usable": true      }    ],    "addonGroups": [      {        "groupId": "og_wrap",        "name": "선물 포장",        "sortOrder": 1,        "required": false,        "values": [          {            "valueId": "ov_wrap_box",            "name": "상자 포장",            "sortOrder": 1,            "additionalPrice": 2000,            "usable": true          }        ]      }    ],    "customInputs": [      {        "inputId": "cin_engrave",        "label": "각인 문구",        "placeholder": "영문 10자까지",        "maxLength": 10,        "required": false,        "usable": true,        "sortOrder": 1      }    ],    "optionSort": "REGISTERED",    "fulfillment": {      "type": "SHIPPING",      "shipping": {        "deliveryType": "CONDITIONAL_FREE",        "deliveryFee": 3000,        "conditionalFreeAmount": 50000,        "shippingAddressId": "adr_ship_main",        "returnAddressId": "adr_return_main"      }    },    "fulfillmentTypeLocked": true,    "refundPolicy": {      "returnDeliveryFee": 3000,      "exchangeDeliveryFee": 6000    },    "discount": null,    "sample": false  },  "error": null}