API
GET /v1/boost/promotion/recommended - 부스트 추천 가져오기(현재 최대 6개)
request headers
{
... // common headers
control-param?: number; // 0 ~ 2까지 부스트 추천 조건 임의로 선택 가능 (테스트 용도)
}
TypeScript
복사
•
control-param은 각 추천 조건에 알맞게 제대로 오는지 확인하기 위한 테스트 용도
◦
운영 배포때는 없어질 예정
◦
현재 추천 조건이 1~3번까지만 구현 가능하기 때문에, 각각 0~2의 control-param으로 매핑되어 있다.
response
// /v1/boost/promotion/available 응답 형식과 동일
interface IBoostPromotionDetail{}
enum RecommendationConditions{
USER_FAVORITES = 'user_favorites',
RECENT_PURCHASES = 'recent_purchases',
FREQUENT_PURCHASES = 'frequent_purchases',
RECENT_VIEWS = 'recent_views', // TODO
}
{
condition: RecommendationConditions;
total: number; // 응답 list 길이
list: IBoostPromotionDetail[];
}
TypeScript
복사
IBoostPromotionDetail
POST /v1/boost/promotion/recommended - 부스트 추천 새로 가져오기(새로고침)
request headers
{
... // common headers
control-param?: number; // 0 ~ 2까지 부스트 추천 조건 임의로 선택 가능 (테스트 용도)
}
TypeScript
복사
request body
enum RecommendationConditions{
USER_FAVORITES = 'user_favorites',
RECENT_PURCHASES = 'recent_purchases',
FREQUENT_PURCHASES = 'frequent_purchases',
RECENT_VIEWS = 'recent_views', // TODO
}
{
previousCondition?: RecommendationConditions;
}
TypeScript
복사
•
previousCondition과 다른 새로운 추천 조건이 적용된 추천 리스트를 반환한다.
◦
previousCondition을 별도로 명시하지 않을 경우 GET과 동일하게 랜덤하게 설정된 추천 조건에 맞는 추천을 반환한다.
response
// /v1/boost/promotion/available 응답 형식과 동일
interface IBoostPromotionDetail{}
enum RecommendationConditions{
USER_FAVORITES = 'user_favorites',
RECENT_PURCHASES = 'recent_purchases',
FREQUENT_PURCHASES = 'frequent_purchases',
RECENT_VIEWS = 'recent_views', // TODO
}
{
condition: RecommendationConditions;
total: number; // 응답 list 길이
list: IBoostPromotionDetail[];
}
TypeScript
복사
IBoostPromotionDetail
