sayren Docs
상품

상품 달력 조회

날짜별 재고 상품(`inventoryMode: DATED`)의 기간(포함, 최대 400일) 재고·가격. 없는 날은 싣지 않는다(재고 0). 일반 상품은 409 `INVENTORY_MODE_NOT_DATED`.

GET
/v1/products/{productId}/calendar

날짜별 재고 상품(inventoryMode: DATED)의 기간(포함, 최대 400일) 재고·가격. 없는 날은 싣지 않는다(재고 0). 일반 상품은 409 INVENTORY_MODE_NOT_DATED.

Authorization

accessToken
headerAuthorizationBearer <token>

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

Path Parameters

productId*string

Query Parameters

variantId?string

조합. 생략하면 모든 조합

from*string

한국 날짜(YYYY-MM-DD)

Match^\d{4}-\d{2}-\d{2}$
to*string

끝 날짜(포함)

Match^\d{4}-\d{2}-\d{2}$

Header Parameters

X-Store-Id*string

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

Response Body

성공

application/json
  1. response
meta*
data*array<>
error*|null
curl -X GET 'https://api.sayren.io/v1/products/string/calendar?from=string&to=string' \  -H 'X-Store-Id: string'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": [    {      "variantId": "string",      "date": "string",      "stock": 0,      "price": 0    }  ],  "error": null}