{"openapi":"3.1.0","info":{"title":"hotinbeauty 공구 API","version":"1.4.0","description":"뷰티 공구 공개 읽기 계약. 깨지는 변경은 90일 전에 알린다. 응답은 사전 집계 스냅샷만 읽고, 요청 안에서 수집·추출을 하지 않는다. monetization 은 none 고정이며 제휴 링크를 만들지 않는다. 1.1.0 (2026-10-18): 선택 필드 visible_until(TimePoint|null). 종료가 없는 period_unknown 은 기준일(시작일, 없으면 게이트를 통과한 출처의 가장 이른 게시 시각) KST+5일 00:00(배타)까지만 목록·레일·검색·허브·패싯·다이제스트·변경 피드 upsert 에 나온다. 기준일을 정할 수 없으면 1970-01-01T00:00:00+09:00 으로 닫고 목록에 넣지 않는다. 종료가 있는 period_unknown 의 null 은 남긴다. 마감임박·오늘 마감·달력에는 없다. 상세는 지난 visible_until 을 유지한다. 목록 ETag 는 그 응답의 정렬된 id 집합 해시를 포함한다. 304 는 그 집합이 같을 때만이다. Cache-Control 의 공유 캐시 수명(s-maxage)은 300초와, 응답에 든 기간 미정의 가장 이른 visible_until 까지 남은 초 중 작은 쪽이다. 1.2.0 (2026-10-22): 목록 행 EventSummary 에 선택 필드 apply_method(ApplyMethod|null). 상세 apply_method 와 같은 값이다. 없으면 옛 문서이고 미상과 같이 읽는다. 가격·할인율 정보가 아니다. 첫 공개 소비자는 1.2.0 을 따른다. 1.3.0 (2026-10-22): GET /v1/gongu 에 선택 파라미터 date_field(end|start)·date(KST YYYY-MM-DD). end 는 진행 중·마감 임박 공구 중 포함 마감일(날짜 정밀도는 그날, 시각이 00:00 이면 전날)이 그날인 것, start 는 오픈 예정 공구 중 그날 여는 것만 낸다. 기간 미정·종료는 날짜 필터에 걸리지 않는다. date 가 없으면 date_field 는 아무것도 거르지 않는다. 새 값은 필터 해시에 들어가 다른 날짜의 cursor 는 400 invalid_cursor 다. 응답 형태는 그대로다. 1.4.0 (HIB-120): 목록 행 EventSummary 와 상세 Event 에 선택 필드 product_types(ProductType[]) 와 primary_product_type(ProductType|null). 같은 판정에서 나온 같은 값이다. 없으면 옛 문서이고 미확인으로 읽는다. 목록 type 파라미터와 facets.product_type 은 이 값을 쓴다."},"servers":[{"url":"https://hotinbeauty.com"}],"tags":[{"name":"gongu","description":"공구 이벤트"},{"name":"sellers","description":"셀러"},{"name":"brands","description":"브랜드"},{"name":"changes","description":"증분 피드"},{"name":"digest","description":"오늘 묶음"}],"paths":{"/v1/gongu":{"get":{"operationId":"listGongu","tags":["gongu"],"summary":"공구 목록","description":"필터는 status·category·q·seller·brand·source 만. source 는 instagram·youtube 이고 이 경로에만 있다. 정렬은 ending_soon·newest 만. status 를 생략하면 진행 묶음만 나오므로 기본 목록(마감 임박순)의 앞자리는 이미 끝난 공구가 아니다. 기본 20건, 최대 100건. 항목은 EventSummary 고정이고 fields 는 받지 않는다. ETag 는 components.headers.ETag 를 따른다. 같은 세대라도 만료로 id 가 빠지거나 요청 시각 상태가 바뀌면 ETag 가 바뀌고 304 가 아니다. Cache-Control 은 components.headers.Cache-Control 을 따르고 공유 캐시 수명은 300초를 넘지 않으며 응답 안 기간 미정의 가장 이른 visible_until 까지 남은 초도 넘지 않는다.","parameters":[{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/category"},{"$ref":"#/components/parameters/q"},{"$ref":"#/components/parameters/seller"},{"$ref":"#/components/parameters/brand"},{"$ref":"#/components/parameters/source"},{"$ref":"#/components/parameters/date_field"},{"$ref":"#/components/parameters/date"},{"$ref":"#/components/parameters/type"},{"$ref":"#/components/parameters/sort"},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/ifNoneMatch"}],"responses":{"200":{"description":"스냅샷 페이지. 결과가 없어도 200 이고 items 는 빈 배열.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageEnvelope"},"examples":{"sample":{"$ref":"#/components/examples/page.sample"}}}}},"304":{"description":"If-None-Match 가 이 목록의 강한 ETag 와 같다. 항목 id 집합이 다르면 304 가 아니다. * 는 표현이 있으므로 RFC 9110 대로 304 다. 본문 없음.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"목록은 404 를 쓰지 않는다. 빈 결과는 200.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"$ref":"#/components/examples/problem.not-found"}}}}},"410":{"$ref":"#/components/responses/CursorGone"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/SnapshotUnavailable"}}}},"/v1/gongu/{id}":{"get":{"operationId":"getGongu","tags":["gongu"],"summary":"공구 한 건","description":"ItemEnvelope. 병합된 ID 도 200 이며 item.merged_into 가 정본을 가리킨다. fields 는 revisions·sources·options 확장이고 기본은 options. 삭제된 ID 는 410 Tombstone 하나다.","parameters":[{"$ref":"#/components/parameters/id"},{"$ref":"#/components/parameters/fieldsDetail"},{"$ref":"#/components/parameters/ifNoneMatch"}],"responses":{"200":{"description":"공구 상세. stale 이어도 200 일 수 있다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"},"examples":{"fresh":{"$ref":"#/components/examples/event.detail"},"stale":{"$ref":"#/components/examples/event.detail.stale"}}}}},"304":{"description":"If-None-Match 가 현재 ETag 와 같다. 본문 없음.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"410":{"description":"삭제된 공구. application/json Tombstone 본문 하나만 준다. problem+json 을 병기하지 않는다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tombstone"},"examples":{"removed":{"$ref":"#/components/examples/event.removed"}}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/SnapshotUnavailable"}}}},"/v1/sellers/{slug}":{"get":{"operationId":"getSeller","tags":["sellers"],"summary":"셀러와 그 공구","description":"slug 로 찾는다. 공구 목록은 같은 필터·정렬·커서를 쓴다.","parameters":[{"$ref":"#/components/parameters/sellerSlug"},{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/category"},{"$ref":"#/components/parameters/sort"},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/ifNoneMatch"}],"responses":{"200":{"description":"ItemEnvelope. as_of·generation·stale·sync_token 이 본문 밖에 있다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"304":{"description":"If-None-Match 가 현재 ETag 와 같다. 본문 없음.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"410":{"$ref":"#/components/responses/CursorGone"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/SnapshotUnavailable"}}}},"/v1/brands/{slug}":{"get":{"operationId":"getBrand","tags":["brands"],"summary":"브랜드와 그 공구","description":"slug 가 공개 식별자다. 별도 brd_ ID 는 없다.","parameters":[{"$ref":"#/components/parameters/brandSlug"},{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/category"},{"$ref":"#/components/parameters/sort"},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/ifNoneMatch"}],"responses":{"200":{"description":"ItemEnvelope. as_of·generation·stale·sync_token 이 본문 밖에 있다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"304":{"description":"If-None-Match 가 현재 ETag 와 같다. 본문 없음.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"410":{"$ref":"#/components/responses/CursorGone"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/SnapshotUnavailable"}}}},"/v1/changes":{"get":{"operationId":"listChanges","tags":["changes"],"summary":"증분 변경","description":"since 는 불투명 배타 토큰이다. sync_token 또는 이전 next_since 를 넣는다. 30일이 지난 토큰은 410 cursor_gone, links.resync 는 /v1/gongu. 형식 오류는 400 invalid_since. 삭제는 Change.op=removed 와 tombstone 으로만 전달한다. 빈 페이지도 next_since 를 돌려주며 그것이 체크포인트다. since 를 생략하면 최근 29일 재생 모드다(parameters.since). limit 은 상한이 아니라 목표치다. 같은 changed_at 묶음은 쪼개지 않으므로 limit 에 닿기 전에 시작한 묶음은 통째로 들어가고 한 페이지가 limit 를 넘을 수 있다(한 묶음이 수백 건일 수 있고 limit=1 도 묶음 하나를 통째로 준다). 그래서 next_since 는 언제나 묶음 경계이고 같은 변경을 두 번 받거나 빠뜨리지 않는다.","parameters":[{"$ref":"#/components/parameters/since"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/ifNoneMatch"}],"responses":{"200":{"description":"변경 페이지. items 는 Change 다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeFeed"},"examples":{"sample":{"$ref":"#/components/examples/change.sample"}}}}},"304":{"description":"If-None-Match 가 현재 ETag 와 같다. 본문 없음.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"이 경로는 404 를 쓰지 않는다. since 를 생략하면 재생 모드 200, 형식이 틀리면 400, 만료면 410.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"$ref":"#/components/examples/problem.not-found"}}}}},"410":{"$ref":"#/components/responses/CursorGone"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/SnapshotUnavailable"}}}},"/v1/digest/today":{"get":{"operationId":"getDigestToday","tags":["digest"],"summary":"오늘 묶음","description":"KST 오늘 날짜의 짧은 사실 한 줄과 소수 공구. 전체 피드가 아니다.","parameters":[{"$ref":"#/components/parameters/ifNoneMatch"}],"responses":{"200":{"description":"ItemEnvelope. as_of·generation·stale·sync_token 이 본문 밖에 있다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"304":{"description":"If-None-Match 가 현재 ETag 와 같다. 본문 없음.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"이 경로는 404 를 쓰지 않는다. 오늘 건이 없어도 200.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"$ref":"#/components/examples/problem.not-found"}}}}},"410":{"$ref":"#/components/responses/CursorGone"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/SnapshotUnavailable"}}}}},"components":{"examples":{"event.active":{"summary":"진행 중","description":"시작·종료 시각이 있고 대표 옵션 가격이 있는 정상 공구. 200.","value":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111101","status":"active","category":"suncare","title_ko":"샘플 수분 선크림 50ml ×2","summary_ko":"샘플랩 수분 선크림 2개 구성, 댓글 신청.","seller_id":"sel_b1b2c3d4-e5f6-4789-8222-222222222201","seller_slug":"sample-beauty","seller_name":"샘플뷰티","brand_slug":"sample-lab","brand_name":"샘플랩","starts_at":{"at":"2026-10-16T11:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-25T20:00:00+09:00","precision":"datetime","is_estimated":false},"representative_option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333301","list_price_krw":35900,"discount_rate":28,"options":[{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333301","label_ko":"50ml ×2","kind":"standard","purchasable":true,"conditional":false,"price_krw":25900,"list_price_krw":35900,"discount_rate":28,"price_as_of":"2026-10-16T11:05:00+09:00","quantity":2,"volume_label":"50ml"},{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333302","label_ko":"50ml ×1","kind":"standard","purchasable":true,"conditional":true,"price_krw":18900,"list_price_krw":22000,"discount_rate":14,"price_as_of":"2026-10-16T11:05:00+09:00","quantity":1,"volume_label":"50ml"}],"evidence":[{"field_path":"ends_at.at","source":"instagram","permalink":"https://www.instagram.com/p/SAMPLEACTIVE01/","excerpt":"10/25 20:00까지 댓글 신청, 2개 25,900원.","observed_at":"2026-10-16T11:05:00+09:00","extractor_version":"fixture-v1","untrusted":true}],"sources":[{"platform":"instagram","permalink":"https://www.instagram.com/p/SAMPLEACTIVE01/","posted_at":"2026-10-16T11:00:00+09:00","primary":true}],"links":{"original":"https://www.instagram.com/p/SAMPLEACTIVE01/","purchase_original":null},"apply_method":"comment","image_url":"https://example.com/gongu/active.webp","image_width":800,"image_height":1000,"monetization":"none","merged_into":null,"updated_at":"2026-10-18T00:15:00+09:00"}},"event.period-unknown":{"summary":"기간 미상","description":"가격은 있으나 시작·종료가 없다. 30일 진행으로 바꾸지 않는다. visible_until 은 가장 이른 게시일 KST+5일 00:00 배타. 기준일이 없으면 1970-01-01T00:00:00+09:00 으로 닫는다. 200.","value":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111102","status":"period_unknown","category":"skincare","title_ko":"샘플 세럼 50ml","summary_ko":"가격은 있으나 시작·종료는 확인되지 않았다.","seller_id":"sel_b1b2c3d4-e5f6-4789-8222-222222222201","seller_slug":"sample-beauty","seller_name":"샘플뷰티","brand_slug":"sample-lab","brand_name":"샘플랩","starts_at":null,"ends_at":null,"visible_until":{"at":"2026-10-22T00:00:00+09:00","precision":"datetime","is_estimated":false},"representative_option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333303","list_price_krw":28000,"discount_rate":22,"options":[{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333303","label_ko":"50ml","kind":"standard","purchasable":true,"conditional":false,"price_krw":21800,"list_price_krw":28000,"discount_rate":22,"price_as_of":"2026-10-17T09:00:00+09:00","quantity":1,"volume_label":"50ml"}],"evidence":[{"field_path":"options.price_krw","source":"instagram","permalink":"https://www.instagram.com/p/SAMPLEPERIOD02/","excerpt":"세럼 21,800원. 기간 문장은 없다.","observed_at":"2026-10-17T09:00:00+09:00","extractor_version":"fixture-v1","untrusted":true}],"sources":[{"platform":"instagram","permalink":"https://www.instagram.com/p/SAMPLEPERIOD02/","posted_at":"2026-10-17T08:40:00+09:00","primary":true}],"links":{"original":"https://www.instagram.com/p/SAMPLEPERIOD02/","purchase_original":null},"apply_method":"dm","image_url":null,"image_width":null,"image_height":null,"monetization":"none","merged_into":null,"updated_at":"2026-10-18T00:15:00+09:00"}},"event.price-corrected":{"summary":"가격 정정","description":"상세에 fields=revisions 를 준 응답. 정정 2건. 200.","value":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111103","status":"active","category":"makeup","title_ko":"샘플 쿠션 15g","summary_ko":"가격이 두 번 정정됐다. 현재 25,900원.","seller_id":"sel_b1b2c3d4-e5f6-4789-8222-222222222201","seller_slug":"sample-beauty","seller_name":"샘플뷰티","brand_slug":"sample-color","brand_name":"샘플컬러","starts_at":{"at":"2026-10-15T20:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-24T23:00:00+09:00","precision":"datetime","is_estimated":false},"representative_option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333311","list_price_krw":36000,"discount_rate":28,"options":[{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333311","label_ko":"15g","kind":"standard","purchasable":true,"conditional":false,"price_krw":25900,"list_price_krw":36000,"discount_rate":28,"price_as_of":"2026-10-17T15:30:00+09:00","quantity":1,"volume_label":"15g"}],"evidence":[{"field_path":"options.opt_c1b2c3d4-e5f6-4789-8333-333333333311.price_krw","source":"instagram","permalink":"https://www.instagram.com/p/SAMPLEPRICE03/","excerpt":"정정 후 15g 25,900원.","observed_at":"2026-10-17T15:30:00+09:00","extractor_version":"fixture-v1","untrusted":true}],"sources":[{"platform":"instagram","permalink":"https://www.instagram.com/p/SAMPLEPRICE03/","posted_at":"2026-10-15T20:00:00+09:00","primary":true}],"links":{"original":"https://www.instagram.com/p/SAMPLEPRICE03/","purchase_original":"https://example.com/apply/sample-cushion"},"apply_method":"link","image_url":"https://example.com/gongu/price.webp","image_width":800,"image_height":800,"monetization":"none","merged_into":null,"updated_at":"2026-10-17T15:30:00+09:00","revisions":[{"revision_no":1,"field_path":"options.opt_c1b2c3d4-e5f6-4789-8333-333333333311.price_krw","previous_text":"32900","next_text":"29900","corrected_at":"2026-10-17T09:00:00+09:00","note":"셀러가 가격을 정정했다."},{"revision_no":2,"field_path":"options.opt_c1b2c3d4-e5f6-4789-8333-333333333311.price_krw","previous_text":"29900","next_text":"25900","corrected_at":"2026-10-17T15:30:00+09:00","note":"셀러가 가격을 다시 정정했다."}]}},"event.merged":{"summary":"병합","description":"merged_into 가 있어도 410 이 아니다. 정본 ID 로 안내하는 200.","value":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111104","status":"active","category":"suncare","title_ko":"샘플 수분 선크림 50ml ×2","summary_ko":"이 기록은 다른 공구로 병합되었다.","seller_id":"sel_b1b2c3d4-e5f6-4789-8222-222222222201","seller_slug":"sample-beauty","seller_name":"샘플뷰티","brand_slug":"sample-lab","brand_name":"샘플랩","starts_at":{"at":"2026-10-16T11:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-25T20:00:00+09:00","precision":"datetime","is_estimated":false},"representative_option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333321","list_price_krw":35900,"discount_rate":28,"options":[{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333321","label_ko":"50ml ×2","kind":"standard","purchasable":true,"conditional":false,"price_krw":25900,"list_price_krw":35900,"discount_rate":28,"price_as_of":"2026-10-16T12:00:00+09:00","quantity":2,"volume_label":"50ml"}],"evidence":[{"field_path":"merged_into","source":"instagram","permalink":"https://www.youtube.com/watch?v=SAMPLEMERGED04","excerpt":"같은 선크림 2개 구성을 한 공구로 본다.","observed_at":"2026-10-18T00:10:00+09:00","extractor_version":"fixture-v1","untrusted":true}],"sources":[{"platform":"youtube","permalink":"https://www.youtube.com/watch?v=SAMPLEMERGED04","posted_at":"2026-10-16T12:00:00+09:00","primary":true}],"links":{"original":"https://www.youtube.com/watch?v=SAMPLEMERGED04","purchase_original":null},"apply_method":"link","image_url":"https://example.com/gongu/merged.webp","image_width":1280,"image_height":720,"monetization":"none","merged_into":"evt_a1b2c3d4-e5f6-4789-8111-111111111101","updated_at":"2026-10-18T00:10:00+09:00"}},"event.removed":{"summary":"삭제","description":"tombstone. 원문·이미지 없음. 410.","value":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111105","removed_at":"2026-10-17T18:00:00+09:00","reason_code":"opt_out","detail":null}},"page.sample":{"summary":"목록 한 페이지","description":"items 6. next_cursor 가 null 이면 마지막 페이지.","value":{"as_of":"2026-10-18T00:15:00+09:00","generation":"gen_4f0c0a2e-7b31-4c1a-8f22-0b6d5a1c1001","stale":false,"sync_token":"sync_sample_page","items":[{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111101","status":"active","category":"suncare","title":"샘플 수분 선크림 50ml ×2","brand":{"slug":"sample-lab","name":"샘플랩"},"seller":{"slug":"sample-beauty","handle":null,"platform":"instagram"},"representative":{"option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333301","sale_price_krw":25900,"list_price_krw":35900,"discount_pct":28},"starts_at":{"at":"2026-10-16T11:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-25T20:00:00+09:00","precision":"datetime","is_estimated":false},"apply_method":"comment","thumbnail":{"url":"https://example.com/gongu/active.webp","width":800,"height":1000},"links":{"original":"https://www.instagram.com/p/SAMPLEACTIVE01/"},"updated_at":"2026-10-18T00:15:00+09:00"},{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111106","status":"ending_soon","category":"hairbody","title":"샘플 샴푸 400ml","brand":{"slug":"sample-hair","name":"샘플헤어"},"seller":{"slug":"sample-beauty","handle":null,"platform":"instagram"},"representative":{"option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333331","sale_price_krw":18000,"list_price_krw":24000,"discount_pct":25},"starts_at":{"at":"2026-10-10T00:00:00+09:00","precision":"day","is_estimated":false},"ends_at":{"at":"2026-10-19T18:00:00+09:00","precision":"datetime","is_estimated":false},"apply_method":"profile_link","thumbnail":null,"links":{"original":"https://www.instagram.com/p/SAMPLESOON06/"},"updated_at":"2026-10-18T00:15:00+09:00"},{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111107","status":"upcoming","category":"innerbeauty","title":"샘플 캡슐 60정","brand":null,"seller":{"slug":"sample-beauty","handle":null,"platform":"instagram"},"representative":null,"starts_at":{"at":"2026-10-20T11:00:00+09:00","precision":"datetime","is_estimated":true},"ends_at":null,"apply_method":"comment","thumbnail":null,"links":{"original":"https://www.instagram.com/p/SAMPLEUPCOMING07/"},"updated_at":"2026-10-18T00:15:00+09:00"},{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111102","status":"period_unknown","category":"skincare","title":"샘플 세럼 50ml","brand":{"slug":"sample-lab","name":"샘플랩"},"seller":{"slug":"sample-beauty","handle":null,"platform":"instagram"},"representative":{"option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333303","sale_price_krw":21800,"list_price_krw":28000,"discount_pct":22},"starts_at":null,"ends_at":null,"visible_until":{"at":"2026-10-22T00:00:00+09:00","precision":"datetime","is_estimated":false},"apply_method":"dm","thumbnail":null,"links":{"original":"https://www.instagram.com/p/SAMPLEPERIOD02/"},"updated_at":"2026-10-18T00:15:00+09:00"},{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111108","status":"sold_out","category":"skincare","title":"샘플 크림 80ml","brand":{"slug":"sample-derma","name":"샘플더마"},"seller":{"slug":"sample-beauty","handle":null,"platform":"instagram"},"representative":null,"starts_at":{"at":"2026-10-12T10:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-28T10:00:00+09:00","precision":"datetime","is_estimated":false},"apply_method":null,"thumbnail":null,"links":{"original":"https://www.instagram.com/p/SAMPLESOLD08/"},"updated_at":"2026-10-18T00:15:00+09:00"},{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111104","status":"active","category":"suncare","title":"샘플 수분 선크림 50ml ×2","brand":{"slug":"sample-lab","name":"샘플랩"},"seller":{"slug":"sample-beauty","handle":null,"platform":"youtube"},"representative":{"option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333321","sale_price_krw":25900,"list_price_krw":35900,"discount_pct":28},"starts_at":{"at":"2026-10-16T11:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-25T20:00:00+09:00","precision":"datetime","is_estimated":false},"apply_method":"link","thumbnail":{"url":"https://example.com/gongu/merged.webp","width":1280,"height":720},"links":{"original":"https://www.youtube.com/watch?v=SAMPLEMERGED04"},"updated_at":"2026-10-18T00:10:00+09:00"}],"next_cursor":null}},"problem.invalid-cursor":{"summary":"잘못된 커서","value":{"type":"https://hotinbeauty.com/v1/problems/invalid_cursor","title":"요청이 올바르지 않습니다","status":400,"code":"invalid_cursor","detail":"커서가 이 경로의 필터와 맞지 않습니다.","request_id":"req_sample_01","links":null}},"problem.cursor-gone":{"summary":"만료된 이어받기","value":{"type":"https://hotinbeauty.com/v1/problems/cursor_gone","title":"이어 받기 토큰이 만료되었습니다","status":410,"code":"cursor_gone","detail":"보존 기간(30일) 밖의 토큰입니다.","request_id":"req_sample_01","links":{"resync":"/v1/gongu"}}},"problem.not-found":{"summary":"없음","value":{"type":"https://hotinbeauty.com/v1/problems/not_found","title":"찾을 수 없습니다","status":404,"code":"not_found","detail":"해당 ID 의 공구가 없습니다.","request_id":"req_sample_01","links":null}},"problem.event-removed":{"summary":"삭제 오류 코드","value":{"type":"https://hotinbeauty.com/v1/problems/event_removed","title":"삭제된 공구입니다","status":410,"code":"event_removed","detail":"삭제된 공구입니다. 상세 응답 본문은 Tombstone 이다.","request_id":"req_sample_01","links":null}},"problem.rate-limited":{"summary":"한도","value":{"type":"https://hotinbeauty.com/v1/problems/rate_limited","title":"요청 한도를 넘었습니다","status":429,"code":"rate_limited","detail":"분당 한도를 넘었습니다.","request_id":"req_sample_01","links":null}},"problem.snapshot-unavailable":{"summary":"스냅샷 없음","value":{"type":"https://hotinbeauty.com/v1/problems/snapshot_unavailable","title":"스냅샷을 쓸 수 없습니다","status":503,"code":"snapshot_unavailable","detail":"제공할 스냅샷이 없습니다. 진행 중으로 확정하지 마세요.","request_id":"req_sample_01","links":null}},"event.detail":{"summary":"신선한 상세","value":{"as_of":"2026-10-18T00:15:00+09:00","generation":"gen_4f0c0a2e-7b31-4c1a-8f22-0b6d5a1c1001","stale":false,"sync_token":"sync_sample_detail","item":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111101","status":"active","category":"suncare","title_ko":"샘플 수분 선크림 50ml ×2","summary_ko":"샘플랩 수분 선크림 2개 구성, 댓글 신청.","seller_id":"sel_b1b2c3d4-e5f6-4789-8222-222222222201","seller_slug":"sample-beauty","seller_name":"샘플뷰티","brand_slug":"sample-lab","brand_name":"샘플랩","starts_at":{"at":"2026-10-16T11:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-25T20:00:00+09:00","precision":"datetime","is_estimated":false},"representative_option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333301","list_price_krw":35900,"discount_rate":28,"options":[{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333301","label_ko":"50ml ×2","kind":"standard","purchasable":true,"conditional":false,"price_krw":25900,"list_price_krw":35900,"discount_rate":28,"price_as_of":"2026-10-16T11:05:00+09:00","quantity":2,"volume_label":"50ml"},{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333302","label_ko":"50ml ×1","kind":"standard","purchasable":true,"conditional":true,"price_krw":18900,"list_price_krw":22000,"discount_rate":14,"price_as_of":"2026-10-16T11:05:00+09:00","quantity":1,"volume_label":"50ml"}],"evidence":[{"field_path":"ends_at.at","source":"instagram","permalink":"https://www.instagram.com/p/SAMPLEACTIVE01/","excerpt":"10/25 20:00까지 댓글 신청, 2개 25,900원.","observed_at":"2026-10-16T11:05:00+09:00","extractor_version":"fixture-v1","untrusted":true}],"sources":[{"platform":"instagram","permalink":"https://www.instagram.com/p/SAMPLEACTIVE01/","posted_at":"2026-10-16T11:00:00+09:00","primary":true}],"links":{"original":"https://www.instagram.com/p/SAMPLEACTIVE01/","purchase_original":null},"apply_method":"comment","image_url":"https://example.com/gongu/active.webp","image_width":800,"image_height":1000,"monetization":"none","merged_into":null,"updated_at":"2026-10-18T00:15:00+09:00"}},"description":"ItemEnvelope. stale 은 false."},"event.detail.stale":{"summary":"스테일 상세","value":{"as_of":"2026-10-18T00:15:00+09:00","generation":"gen_4f0c0a2e-7b31-4c1a-8f22-0b6d5a1c1001","stale":true,"sync_token":"sync_sample_detail_stale","item":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111101","status":"active","category":"suncare","title_ko":"샘플 수분 선크림 50ml ×2","summary_ko":"샘플랩 수분 선크림 2개 구성, 댓글 신청.","seller_id":"sel_b1b2c3d4-e5f6-4789-8222-222222222201","seller_slug":"sample-beauty","seller_name":"샘플뷰티","brand_slug":"sample-lab","brand_name":"샘플랩","starts_at":{"at":"2026-10-16T11:00:00+09:00","precision":"datetime","is_estimated":false},"ends_at":{"at":"2026-10-25T20:00:00+09:00","precision":"datetime","is_estimated":false},"representative_option_id":"opt_c1b2c3d4-e5f6-4789-8333-333333333301","list_price_krw":35900,"discount_rate":28,"options":[{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333301","label_ko":"50ml ×2","kind":"standard","purchasable":true,"conditional":false,"price_krw":25900,"list_price_krw":35900,"discount_rate":28,"price_as_of":"2026-10-16T11:05:00+09:00","quantity":2,"volume_label":"50ml"},{"id":"opt_c1b2c3d4-e5f6-4789-8333-333333333302","label_ko":"50ml ×1","kind":"standard","purchasable":true,"conditional":true,"price_krw":18900,"list_price_krw":22000,"discount_rate":14,"price_as_of":"2026-10-16T11:05:00+09:00","quantity":1,"volume_label":"50ml"}],"evidence":[{"field_path":"ends_at.at","source":"instagram","permalink":"https://www.instagram.com/p/SAMPLEACTIVE01/","excerpt":"10/25 20:00까지 댓글 신청, 2개 25,900원.","observed_at":"2026-10-16T11:05:00+09:00","extractor_version":"fixture-v1","untrusted":true}],"sources":[{"platform":"instagram","permalink":"https://www.instagram.com/p/SAMPLEACTIVE01/","posted_at":"2026-10-16T11:00:00+09:00","primary":true}],"links":{"original":"https://www.instagram.com/p/SAMPLEACTIVE01/","purchase_original":null},"apply_method":"comment","image_url":"https://example.com/gongu/active.webp","image_width":800,"image_height":1000,"monetization":"none","merged_into":null,"updated_at":"2026-10-18T00:15:00+09:00"}},"description":"이전 세대를 그대로 주는 상세. stale 은 true."},"change.sample":{"summary":"upsert 와 삭제","value":{"as_of":"2026-10-18T00:15:00+09:00","generation":"gen_4f0c0a2e-7b31-4c1a-8f22-0b6d5a1c1001","items":[{"event_id":"evt_a1b2c3d4-e5f6-4789-8111-111111111101","op":"upsert","changed_at":"2026-10-18T00:15:00+09:00","merged_into":null,"tombstone":null},{"event_id":"evt_a1b2c3d4-e5f6-4789-8111-111111111105","op":"removed","changed_at":"2026-10-17T18:00:00+09:00","merged_into":null,"tombstone":{"id":"evt_a1b2c3d4-e5f6-4789-8111-111111111105","removed_at":"2026-10-17T18:00:00+09:00","reason_code":"opt_out","detail":null}}],"next_since":"sync_sample_changes","has_more":false},"description":"삭제는 removed 와 tombstone 만 있다."},"problem.invalid-query":{"summary":"잘못된 쿼리","value":{"type":"https://hotinbeauty.com/v1/problems/invalid_query","title":"요청이 올바르지 않습니다","status":400,"code":"invalid_query","detail":"status=removed 는 목록 필터가 아닙니다.","request_id":"req_sample_01","links":null}},"problem.invalid-since":{"summary":"잘못된 since","value":{"type":"https://hotinbeauty.com/v1/problems/invalid_since","title":"요청이 올바르지 않습니다","status":400,"code":"invalid_since","detail":"since 토큰 형식이 올바르지 않습니다.","request_id":"req_sample_01","links":null}}},"parameters":{"status":{"name":"status","in":"query","required":false,"description":"공개 상태 하나. period_unknown 을 포함한다. visible_until 이 지났거나, 종료가 없는데 visible_until 이 없는 기간 미정은 목록에서 빠진다. removed 를 주면 400 invalid_query. 생략하면 웹 피드와 같은 진행 묶음(upcoming·active·ending_soon·period_unknown)만 낸다. ended·cancelled·sold_out 은 그 값을 status 로 고를 때만 나온다.","schema":{"$ref":"#/components/schemas/PublicStatus"}},"category":{"name":"category","in":"query","required":false,"description":"뷰티 하위 분류 하나. beauty 라는 값은 없다.","schema":{"$ref":"#/components/schemas/Category"}},"q":{"name":"q","in":"query","required":false,"description":"제품·브랜드·셀러 검색어. NFC, trim, 연속 공백은 한 칸. 60자, 토큰 5개. 대소문자·순서·중복과 토큰 앞의 @ 는 같은 검색이다. 빈 값이나 공백만 주면 검색하지 않는다(필터 없음, 400 아님).","schema":{"type":"string","maxLength":60}},"seller":{"name":"seller","in":"query","required":false,"description":"셀러 slug.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"}},"brand":{"name":"brand","in":"query","required":false,"description":"브랜드 slug.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"}},"source":{"name":"source","in":"query","required":false,"description":"출처 플랫폼 하나. instagram 또는 youtube. 생략하면 플랫폼을 가리지 않는다. GET /v1/gongu 만 받는다. 셀러·브랜드 경로에는 없다.","schema":{"$ref":"#/components/schemas/SourcePlatform"}},"date_field":{"name":"date_field","in":"query","required":false,"description":"날짜 필터의 기준. end(기본)는 마감일, start 는 오픈일. date 와 함께 줄 때만 거른다. date 없이 주면 필터가 없다. GET /v1/gongu 만 받는다.","schema":{"type":"string","enum":["end","start"],"default":"end"}},"date":{"name":"date","in":"query","required":false,"description":"KST 달력 날짜 YYYY-MM-DD. date_field=end 면 진행 중·마감 임박 공구 중 그날 끝나는 것(날짜 정밀도 마감은 그날, 시각 정밀도 00:00 마감은 전날), start 면 오픈 예정 공구 중 그날 여는 것만 낸다. 날짜를 알 수 없는 공구(기간 미정)는 빠진다. 없는 날짜(2026-02-30)는 400 invalid_query.","schema":{"type":"string","pattern":"^(?:[1-9]\\d{3}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|02-(?:0[1-9]|1\\d|2[0-8]))|(?:[1-9]\\d(?:0[48]|[2468][048]|[13579][26])|(?:[2468][048]|[13579][26])00)-02-29)$"}},"type":{"name":"type","in":"query","required":false,"description":"제품 종류 id 하나(1.4.0). 목록 행의 product_types 에 이 값이 있는 공구만 낸다. 종류를 확인하지 못한 공구(빈 배열)는 빠진다. enum 밖이면 invalid_query, 지금 공개하지 않는 종류는 빈 목록이다. 커서는 이 값과 묶인다. GET /v1/gongu 만 받는다.","schema":{"$ref":"#/components/schemas/ProductType"}},"sort":{"name":"sort","in":"query","required":false,"description":"정렬. 생략하면 ending_soon. newest 만 더 허용한다. 추천·할인율순은 없다.","schema":{"allOf":[{"$ref":"#/components/schemas/Sort"}],"default":"ending_soon"}},"cursor":{"name":"cursor","in":"query","required":false,"description":"이전 페이지의 next_cursor. filter_hash 는 경로를 포함한다. /v1/gongu 와 /v1/sellers/{slug} 는 필터가 같아도 다른 해시이고, 셀러·브랜드 경로는 slug 를 넣는다. 변조·필터 불일치는 400 invalid_cursor. 만료이거나 그 세대가 죽었으면 410 cursor_gone.","schema":{"type":"string","minLength":1}},"limit":{"name":"limit","in":"query","required":false,"description":"페이지 크기. 생략하면 20, 최대 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},"fieldsDetail":{"name":"fields","in":"query","required":false,"description":"상세 전용 확장. revisions, sources, options 를 쉼표로 여러 개 둔다. 생략하면 options 만 있고 revisions 와 sources 는 빠진다. 필드를 빼는 의미가 아니다. 없는 이름은 400 invalid_query. 목록에는 없다.","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["revisions","sources","options"]}}},"since":{"name":"since","in":"query","required":false,"description":"불투명 배타 토큰. 목록·상세의 sync_token 또는 이전 next_since. 시각 문자열이나 0 이 아니다. 형식이 틀리면 400 invalid_since. 30일이 지나면 410 cursor_gone 이고 links.resync 는 /v1/gongu. 생략하면 재생 모드다: 요청 시각에서 29일 전(초 내림) 이후의 변경부터 준다. 토큰 보존 30일보다 하루 짧아 돌려받은 next_since 가 바로 410 이 되지 않는다. 전체 상태가 필요하면 /v1/gongu 를 받고 그 sync_token 에서 시작한다.","schema":{"type":"string","minLength":1,"maxLength":2000}},"id":{"name":"id","in":"path","required":true,"description":"evt_ 와 UUID v4.","schema":{"type":"string","pattern":"^evt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"}},"sellerSlug":{"name":"slug","in":"path","required":true,"description":"셀러 slug.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"}},"brandSlug":{"name":"slug","in":"path","required":true,"description":"브랜드 slug.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"}},"ifNoneMatch":{"name":"If-None-Match","in":"header","required":false,"description":"이전 ETag. 같은 강한 태그일 때만 304. 약한 W/ 는 그 강한 태그와 같다. 목록은 응답 id 집합이 같아야 한다. * 는 표현이 있으면 맞으므로 304 다(RFC 9110).","schema":{"type":"string"}}},"headers":{"ETag":{"description":"목록은 계약 버전 1.1.0, generation, 경로, 정규화 필터(status 생략 시 진행 묶음 표시 포함), 정렬, fields(목록은 빈 값), 요청 커서, 그 응답 items 의 id 를 정렬한 목록의 sha256, 그리고 요청 시각 기준 응답 표현(상태·시각 등)을 한 단위로 해시해 강한 따옴표 태그로 준다. 응답의 next_cursor 는 위치만 넣고 만료 시각은 넣지 않으며 대신 발급 시각의 정시(1시간 단위)를 넣는다. 그래서 같은 세대·같은 시간대의 같은 요청은 같은 ETag 이고 If-None-Match 로 304 를 받는다. 304 로 재사용한 next_cursor 는 최소 23시간 유효하다. 같은 세대라도 그 id 집합이나 상태가 다르면 ETag 가 다르고 304 가 아니다. 목록이 아닌 응답은 계약 버전, generation, 정규화 필터, 정렬, fields, 커서와 응답 표현을 해시한다.","required":true,"schema":{"type":"string"}},"Cache-Control":{"description":"공유 캐시용 응답은 public, max-age=0, s-maxage=N, stale-while-revalidate=S 다. 브라우저는 매번 재검증하고 CDN 만 N 초 쓴다. N 은 300초(세대가 stale 이면 30초)를 넘지 않는다. 응답에 기간 미정 항목의 visible_until 이 있으면 N 은 그 중 가장 이른 시각까지 남은 초(내림)도 넘지 않는다. 응답 항목과 세대의 다음 상태 전환 시각까지 남은 초도 상한이고, S 는 그 남은 초에서 N 을 뺀 값과 60 중 작은 쪽이다(남은 초가 60 이하면 0). 이미 지났거나 시각을 읽을 수 없거나 전환 시각을 알 수 없는 응답(해석하지 못한 변경 피드 upsert, openapi.json)은 private, no-store 다. 오류 응답은 no-store 다. 종료가 있는 period_unknown 의 null 은 이 상한에 넣지 않는다. 공구 외 스냅샷 주기는 이 계약이 바꾸지 않는다.","required":true,"schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"이 창의 최대 요청 수. 숫자 한도는 헤더로만 알리고 계약에 고정하지 않는다.","required":true,"schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"이 창에 남은 요청 수.","required":true,"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"창이 다시 열리는 유닉스 초.","required":true,"schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"다시 요청하기까지 기다릴 초. 429 는 지금 분 창이 다시 열릴 때까지 남은 초(1~60, X-RateLimit-Reset 과 같은 시각), 503 은 30. 400·404·410 에는 두지 않는다.","required":true,"schema":{"type":"integer","minimum":0}}},"responses":{"BadRequest":{"description":"쿼리는 invalid_query, since 형식은 invalid_since, 커서 변조·필터 불일치는 invalid_cursor. 400 에는 Retry-After 가 없다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"invalid_query":{"$ref":"#/components/examples/problem.invalid-query"},"invalid_since":{"$ref":"#/components/examples/problem.invalid-since"},"invalid_cursor":{"$ref":"#/components/examples/problem.invalid-cursor"}}}}},"NotFound":{"description":"ID 또는 slug 가 없다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"$ref":"#/components/examples/problem.not-found"}}}}},"CursorGone":{"description":"커서나 since 가 만료됐거나 세대를 더 이상 쓸 수 없다. links.resync 는 /v1/gongu. Retry-After 는 없다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"cursor_gone":{"$ref":"#/components/examples/problem.cursor-gone"}}}}},"RateLimited":{"description":"IP·키 또는 검색(q) 한도 초과.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"$ref":"#/components/examples/problem.rate-limited"}}}}},"SnapshotUnavailable":{"description":"줄 스냅샷이 없다. 이전 스냅샷이 있으면 503 대신 200 과 stale=true 이며, 그때는 진행 중 확정을 멈춘다.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"snapshot_unavailable":{"$ref":"#/components/examples/problem.snapshot-unavailable"}}}}}},"schemas":{"DatePrecision":{"description":"day 는 날짜만, datetime 은 시각까지.","type":"string","enum":["day","datetime"]},"Category":{"description":"뷰티 하위 분류. 사이트 전체가 뷰티라 beauty 값은 없다.","type":"string","enum":["suncare","skincare","makeup","hairbody","innerbeauty","other"]},"ApplyMethod":{"description":"신청 방법. 댓글·DM 은 URL 없이 이 값만 쓴다.","type":"string","enum":["comment","link","dm","profile_link","other"]},"ProductType":{"description":"제품 종류 id(HIB-120, 1.4.0). 판매 품목의 형태와 쓰임이다. 효능·홍보어는 종류가 아니다. id 는 바뀌지 않고 새 id 가 더해질 수 있으니 모르는 값은 무시한다. 공개 문서에는 검증 기준(종류별 정밀도 0.95 이상)을 통과한 종류만 나온다.","type":"string","enum":["sunscreen","sun_stick","sun_cushion","cleanser","toner","toner_pad","mist","serum_ampoule","cream_lotion","face_oil","mask_pack","eye_care","lip_care","cushion","foundation","base_concealer","powder_fixer","lip_makeup","eye_makeup","cheek_contour","shampoo_scalp","hair_treatment","body_cleanser","body_hand","beauty_supplement","fragrance","beauty_device","beauty_tool","personal_hygiene"]},"OptionKind":{"description":"standard 만 대표가 후보. coupon·addon·gift 는 빼다.","type":"string","enum":["standard","coupon","addon","gift"]},"SourcePlatform":{"description":"출처 플랫폼. 판매처와 섞지 않는다.","type":"string","enum":["instagram","youtube"]},"ProblemCode":{"description":"invalid_cursor 는 목록 커서만. 쿼리는 invalid_query, since 형식은 invalid_since. 삭제 상세 본문은 이 코드가 아니라 Tombstone 이다.","type":"string","enum":["invalid_cursor","invalid_query","invalid_since","cursor_gone","not_found","event_removed","rate_limited","snapshot_unavailable"]},"ChangeOp":{"description":"변경 종류. 삭제는 removed 와 tombstone 만 싣고 원문·이미지는 없다.","type":"string","enum":["upsert","removed","merge"]},"TombstoneReason":{"description":"삭제 이유. 원문 인용을 대신하지 않는다.","type":"string","enum":["opt_out","source_deleted","rights","operator","other"]},"Sort":{"description":"정렬 두 값. 추천·할인율순은 없다.","type":"string","enum":["ending_soon","newest"]},"TimePoint":{"description":"시작 또는 종료 한 경계. at 은 date-time 이고 오프셋은 +09:00 만. precision 이 day 이면 at 은 정확히 T00:00:00+09:00 이다. 달력에 없는 날짜는 거절한다.","type":"object","additionalProperties":false,"required":["at","precision","is_estimated"],"properties":{"at":{"description":"KST 시각. day 이면 그날 00:00:00+09:00.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"precision":{"description":"날짜만인지 시각까지인지. day 의 종료는 다음날 00:00 이 배타 끝이고, 시작은 그날 00:00 을 포함한다.","allOf":[{"$ref":"#/components/schemas/DatePrecision"}]},"is_estimated":{"description":"문장이 추정이면 true. 상태 계산은 이 시각을 그대로 쓴다.","type":"boolean"}}},"Links":{"description":"원문 이동 주소.","type":"object","additionalProperties":false,"required":["original","purchase_original"],"properties":{"original":{"description":"출처 게시물 permalink. 구매 URL 이 아니다.","type":"string","format":"uri"},"purchase_original":{"description":"판매·신청 URL. null 은 별도 URL 이 없음(해당 없음).","type":["string","null"],"format":"uri"}}},"Evidence":{"description":"필드 하나의 공개 발췌. 내부 근거 전문이 아니다.","type":"object","additionalProperties":false,"required":["field_path","source","permalink","excerpt","observed_at","extractor_version","untrusted"],"properties":{"field_path":{"description":"이 발췌가 받치는 필드 경로.","type":"string"},"source":{"description":"출처 이름. instagram, youtube, seller_correction.","type":"string"},"permalink":{"description":"발췌를 본 게시물 주소.","type":"string","format":"uri"},"excerpt":{"description":"공개 발췌. 200자 이하.","type":"string","maxLength":200},"observed_at":{"description":"발췌를 관측한 KST 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"extractor_version":{"description":"발췌를 만든 추출기 버전.","type":"string"},"untrusted":{"description":"발췌는 비신뢰 입력. 항상 true.","const":true}}},"OfferOption":{"description":"옵션 하나의 가격·구성.","type":"object","additionalProperties":false,"required":["id","label_ko","kind","purchasable","conditional","price_krw","list_price_krw","discount_rate","price_as_of","quantity","volume_label"],"properties":{"id":{"description":"opt_ 와 UUID v4. 가격이 바뀌어도 유지하고, 구성이 바뀌면 새로 발급한다.","type":"string","pattern":"^opt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"label_ko":{"description":"구성 이름.","type":"string"},"kind":{"description":"옵션 종류.","allOf":[{"$ref":"#/components/schemas/OptionKind"}]},"purchasable":{"description":"지금 살 수 있으면 true. false 는 품절처럼 구매 불가다.","type":"boolean"},"conditional":{"description":"조건이 있으면 true. 대표가에서 제외한다.","type":"boolean"},"price_krw":{"description":"판매가 정수 KRW. null 은 가격 미확인. 0 은 무상.","type":["integer","null"],"minimum":0},"list_price_krw":{"description":"이 옵션의 정상가. null 은 정상가 미확인.","type":["integer","null"],"minimum":0},"discount_rate":{"description":"이 옵션의 할인율 정수 %. null 은 할인율 미확인.","type":["integer","null"],"minimum":0,"maximum":100},"price_as_of":{"description":"가격 관측 시각. 가격이 null 이면 null(해당 없음).","type":["string","null"],"format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"quantity":{"description":"개수. null 은 수량 미확인.","type":["integer","null"],"minimum":1},"volume_label":{"description":"용량 표기. null 은 용량 미확인.","type":["string","null"]}}},"Revision":{"description":"필드 정정 한 건. 삭제분에는 철회된 원문·이미지를 넣지 않는다.","type":"object","additionalProperties":false,"required":["revision_no","field_path","previous_text","next_text","corrected_at","note"],"properties":{"revision_no":{"description":"이 이벤트 안에서 1부터 증가.","type":"integer","minimum":1},"field_path":{"description":"바뀐 필드 경로.","type":"string"},"previous_text":{"description":"이전 값 문자열. null 은 이전 값이 없었음(해당 없음).","type":["string","null"]},"next_text":{"description":"새 값 문자열. 원문 전문이 아니다.","type":"string","maxLength":200},"corrected_at":{"description":"정정이 반영된 KST 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"note":{"description":"정정 메모. null 은 메모 없음(미기재).","type":["string","null"]}}},"Source":{"description":"출처 게시물 하나. 이벤트와 다대다.","type":"object","additionalProperties":false,"required":["platform","permalink","posted_at","primary"],"properties":{"platform":{"description":"출처 플랫폼.","allOf":[{"$ref":"#/components/schemas/SourcePlatform"}]},"permalink":{"description":"그 게시물 주소.","type":"string","format":"uri"},"posted_at":{"description":"게시 시각. null 은 게시 시각 미확인.","type":["string","null"],"format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"primary":{"description":"대표 출처. 이벤트당 하나이고 links.original 과 같다.","type":"boolean"}}},"Event":{"description":"공개 공구 한 건. representative_option_id 는 조건 없는 구매 가능 표준 옵션 중 최저가 id 와 같아야 하고, 후보가 없으면 null 이다. 조건부·증정·쿠폰·추가구매·구매 불가 옵션을 지정하면 실패한다. 정상가·할인율은 그 옵션의 값만 싣는다. 시작 < 종료는 precision 을 정규화한 뒤(day 시작은 00:00 포함, day 종료는 다음날 00:00 배타) 검사한다. options 는 기본으로 있고, sources·revisions 는 fields 확장일 때만 있다.","type":"object","additionalProperties":false,"required":["id","status","category","title_ko","summary_ko","seller_id","seller_slug","seller_name","brand_slug","brand_name","starts_at","ends_at","representative_option_id","list_price_krw","discount_rate","options","evidence","links","apply_method","image_url","image_width","image_height","monetization","merged_into","updated_at"],"properties":{"id":{"description":"evt_ 와 UUID v4. 날짜·가격·핸들을 넣지 않는다.","type":"string","pattern":"^evt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"status":{"description":"스냅샷 시각에 계산한 공개 상태. removed 는 들어가지 않는다.","allOf":[{"$ref":"#/components/schemas/PublicStatus"}]},"category":{"description":"하위 분류.","allOf":[{"$ref":"#/components/schemas/Category"}]},"title_ko":{"description":"제품·구성 이름. 200자 이하.","type":"string","maxLength":200},"summary_ko":{"description":"사실 한 줄. 80자 이하. null 은 요약이 아직 없음(미확인).","type":["string","null"],"maxLength":80},"seller_id":{"description":"셀러 공개 ID. sel_ 와 UUID v4.","type":"string","pattern":"^sel_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"seller_slug":{"description":"셀러 slug. 스냅샷에 박힌 표시값.","type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"seller_name":{"description":"셀러 표시 이름.","type":"string"},"brand_slug":{"description":"브랜드 slug. null 은 브랜드 미확인.","type":["string","null"],"pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"brand_name":{"description":"브랜드 이름. slug 와 같이 null 이거나 같이 있다. null 은 미확인.","type":["string","null"]},"starts_at":{"description":"시작 경계. null 은 시작 미확인.","anyOf":[{"$ref":"#/components/schemas/TimePoint"},{"type":"null"}]},"ends_at":{"description":"종료 경계. null 은 종료 미확인. day 는 다음날 00:00 이 배타 끝이다. 정규화한 시작보다 뒤여야 한다.","anyOf":[{"$ref":"#/components/schemas/TimePoint"},{"type":"null"}]},"visible_until":{"description":"종료가 없고 기준일이 있는 period_unknown 만. 기준일(시작일, 없으면 게이트를 통과한 출처 중 가장 이른 게시 시각)의 KST 날짜 + 5일 00:00(+09:00) 배타. 그 시각부터 목록·레일·검색·셀러·브랜드 허브·패싯·다이제스트·변경 피드 upsert 에서 빠지고 상세는 남는다. 기준일을 정할 수 없으면 1970-01-01T00:00:00+09:00(datetime, is_estimated false)이다. 이 시각은 5일 창이 아니라 노출 불가 표식이다. 종료가 있는 period_unknown 과 다른 상태는 null. 필드가 없는 옛 문서라도 종료가 없고 visible_until 이 없으면 서버는 목록에 넣지 않는다.","anyOf":[{"$ref":"#/components/schemas/TimePoint"},{"type":"null"}]},"representative_option_id":{"description":"대표 옵션 ID. pick 의 id 와 같아야 한다. null 은 조건 없는 구매 가능 옵션이 없음(해당 없음).","type":["string","null"],"pattern":"^opt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"list_price_krw":{"description":"대표 옵션의 정상가만. null 은 대표가 없거나 그 정상가 미확인.","type":["integer","null"],"minimum":0},"discount_rate":{"description":"대표 옵션의 할인율만. null 은 대표가 없거나 할인율 미확인.","type":["integer","null"],"minimum":0,"maximum":100},"options":{"description":"옵션 목록.","type":"array","items":{"$ref":"#/components/schemas/OfferOption"}},"evidence":{"description":"필드별 공개 발췌.","type":"array","items":{"$ref":"#/components/schemas/Evidence"}},"sources":{"description":"출처 게시물. fields=sources 일 때만 있다. 있으면 하나 이상이고 primary 하나가 links.original 과 같다.","type":"array","minItems":1,"items":{"$ref":"#/components/schemas/Source"}},"links":{"description":"원문·신청 주소.","allOf":[{"$ref":"#/components/schemas/Links"}]},"apply_method":{"description":"신청 방법. null 은 신청 방법 미확인.","anyOf":[{"$ref":"#/components/schemas/ApplyMethod"},{"type":"null"}]},"product_types":{"description":"확인된 판매 품목의 종류 집합(1.4.0). 빈 배열은 미확인이다. 키가 없으면 옛 문서이고 미확인과 같이 읽는다. 사은품·부속품은 넣지 않는다. 세트는 구성품 종류를 모두 담는다.","type":"array","maxItems":29,"uniqueItems":true,"items":{"$ref":"#/components/schemas/ProductType"}},"primary_product_type":{"description":"대표 종류(1.4.0). 단일 품목이거나 주제품이 분명할 때만 product_types 안의 값이고, 세트·미확인은 null 이다.","anyOf":[{"$ref":"#/components/schemas/ProductType"},{"type":"null"}]},"image_url":{"description":"재호스팅 썸네일. null 은 공개 이미지가 없음(해당 없음).","type":["string","null"],"format":"uri"},"image_width":{"description":"썸네일 가로 픽셀. 이미지가 없으면 null(해당 없음). 있으면 null 은 미확인.","type":["integer","null"],"minimum":1},"image_height":{"description":"썸네일 세로 픽셀. 이미지가 없으면 null(해당 없음). 있으면 null 은 미확인.","type":["integer","null"],"minimum":1},"monetization":{"description":"수익화 없음. 항상 none.","const":"none"},"merged_into":{"description":"정본 evt_ ID. null 은 병합되지 않은 정본(해당 없음). 값이 있어도 응답은 200.","type":["string","null"],"pattern":"^evt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"updated_at":{"description":"이 공개 행이 마지막으로 바뀐 KST 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"revisions":{"description":"정정 이력. fields=revisions 일 때만, 최신 50건. 기본 응답에는 없다.","type":"array","maxItems":50,"items":{"$ref":"#/components/schemas/Revision"}}}},"Seller":{"description":"사람 또는 브랜드 단위 셀러.","type":"object","additionalProperties":false,"required":["id","slug","display_name","instagram_handle","youtube_channel_id"],"properties":{"id":{"description":"sel_ 와 UUID v4.","type":"string","pattern":"^sel_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"slug":{"description":"불변에 가까운 공개 slug.","type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"display_name":{"description":"표시 이름.","type":"string"},"instagram_handle":{"description":"인스타 핸들. null 은 계정 미확인.","type":["string","null"]},"youtube_channel_id":{"description":"유튜브 채널 ID. null 은 채널 미확인.","type":["string","null"]}}},"Brand":{"description":"브랜드. 공개 키는 slug 뿐이다.","type":"object","additionalProperties":false,"required":["slug","name_ko","name_en"],"properties":{"slug":{"description":"브랜드 slug.","type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"name_ko":{"description":"한국어 이름.","type":"string"},"name_en":{"description":"영문 이름. null 은 영문명 미확인.","type":["string","null"]}}},"Tombstone":{"description":"삭제된 공개의 자리. 원문·이미지를 남기지 않는다.","type":"object","additionalProperties":false,"required":["id","removed_at","reason_code","detail"],"properties":{"id":{"description":"삭제된 evt_ ID. 이 ID 는 재사용하지 않는다.","type":"string","pattern":"^evt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"removed_at":{"description":"공개에서 빠진 KST 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"reason_code":{"description":"삭제 이유 코드.","allOf":[{"$ref":"#/components/schemas/TombstoneReason"}]},"detail":{"description":"짧은 공개 문구. null 은 추가 문구 없음(해당 없음).","type":["string","null"]}}},"Problem":{"description":"application/problem+json 본문.","type":"object","additionalProperties":false,"required":["type","title","status","code","detail","request_id","links"],"properties":{"type":{"description":"이 오류 종류의 URI(https://hotinbeauty.com/v1/problems/{code}). GET 하면 그 코드의 설명 JSON(code·status·title·description)을 준다.","type":"string","format":"uri"},"title":{"description":"짧은 제목.","type":"string"},"status":{"description":"HTTP 상태와 같은 정수.","type":"integer","minimum":400,"maximum":599},"code":{"description":"기계가 분기하는 코드.","allOf":[{"$ref":"#/components/schemas/ProblemCode"}]},"detail":{"description":"사람과 에이전트가 읽는 한 문장. 400 은 문제 된 파라미터 이름으로 시작한다(예: \"limit: 값이 올바르지 않습니다. 허용: 1~100 정수.\"). 그 외 코드는 다음에 할 일을 알린다. null 은 추가 설명 없음.","type":["string","null"]},"request_id":{"description":"요청 추적 ID. 비밀이 아니다.","type":"string"},"links":{"description":"cursor_gone 이면 resync 가 /v1/gongu. 그 외에는 null.","anyOf":[{"$ref":"#/components/schemas/ProblemLinks"},{"type":"null"}]}}},"PageEnvelope":{"description":"공구 목록 페이지. sync_token 이 변경 피드 since 의 시작점이다.","type":"object","additionalProperties":false,"required":["as_of","generation","stale","sync_token","items","next_cursor"],"properties":{"as_of":{"description":"이 페이지를 만든 스냅샷 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"generation":{"description":"스냅샷 세대 ID. 시각이나 선할당 순번이 아니다.","type":"string"},"stale":{"description":"갱신에 실패해 이전 세대를 주면 true. 진행 중 확정으로 쓰지 않는다.","type":"boolean"},"items":{"description":"이 페이지의 공구 요약. Event 전문이 아니다.","type":"array","items":{"$ref":"#/components/schemas/EventSummary"}},"next_cursor":{"description":"다음 페이지 커서. null 은 다음이 없음(해당 없음).","type":["string","null"]},"sync_token":{"description":"전체 동기화 뒤 /v1/changes 의 since 로 쓰는 불투명 배타 토큰.","type":"string","minLength":1,"maxLength":2000}}},"Change":{"description":"증분 한 건. 삭제는 op=removed 와 tombstone 만 있고 원문·이미지는 없다.","type":"object","additionalProperties":false,"required":["event_id","op","changed_at","merged_into","tombstone"],"properties":{"event_id":{"description":"대상 evt_ ID.","type":"string","pattern":"^evt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"op":{"description":"upsert, removed, merge.","allOf":[{"$ref":"#/components/schemas/ChangeOp"}]},"changed_at":{"description":"공개에 반영된 KST 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"merged_into":{"description":"merge 일 때의 정본 ID. 그 외에는 null(해당 없음).","type":["string","null"],"pattern":"^evt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"tombstone":{"description":"removed 일 때의 삭제 자리. 그 외에는 null.","anyOf":[{"$ref":"#/components/schemas/Tombstone"},{"type":"null"}]}}},"ChangeFeed":{"description":"증분 페이지. next_cursor 는 없다. next_since 는 배타 체크포인트이고 빈 페이지에도 돌려준다. 그것이 다음 since 다.","type":"object","additionalProperties":false,"required":["as_of","generation","items","next_since","has_more"],"properties":{"as_of":{"description":"이 피드를 만든 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"generation":{"description":"스냅샷 세대 ID.","type":"string","minLength":1,"maxLength":80},"items":{"description":"체크포인트 이후의 변경.","type":"array","items":{"$ref":"#/components/schemas/Change"}},"next_since":{"description":"다음 호출에 넣을 배타 토큰. 빈 페이지여도 있다.","type":"string","minLength":1,"maxLength":2000},"has_more":{"description":"이 페이지 뒤에 변경이 더 있으면 true.","type":"boolean"}}},"PublicStatus":{"description":"공개 상태. removed 는 없다. 삭제는 상세 410 Tombstone 과 변경 피드 op=removed 로만 나간다. period_unknown 은 종료가 없거나, 종료만 있고 판매 근거가 없는 상태다. 목록 노출은 visible_until 로 자른다. 기준일이 없는 기간 미정은 목록에 없다.","type":"string","enum":["upcoming","active","ending_soon","ended","cancelled","sold_out","period_unknown"]},"ProblemLinks":{"description":"이어받기를 포기하고 다시 맞출 경로.","type":"object","additionalProperties":false,"required":["resync"],"properties":{"resync":{"description":"전체 동기화 시작 경로.","type":"string","const":"/v1/gongu"}}},"SummarySeller":{"description":"목록에 싣는 셀러. slug·핸들·플랫폼만.","type":"object","additionalProperties":false,"required":["slug","handle","platform"],"properties":{"slug":{"description":"셀러 slug.","type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"handle":{"description":"플랫폼 핸들. null 은 핸들 미확인.","type":["string","null"],"minLength":1,"maxLength":40},"platform":{"description":"대표 출처 플랫폼.","allOf":[{"$ref":"#/components/schemas/SourcePlatform"}]}}},"SummaryBrand":{"description":"목록에 싣는 브랜드. 없으면 null.","type":"object","additionalProperties":false,"required":["slug","name"],"properties":{"slug":{"description":"브랜드 slug.","type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"name":{"description":"브랜드 이름.","type":"string","minLength":1,"maxLength":80}}},"SummaryRepresentative":{"description":"목록의 대표 옵션 가격. 후보가 없으면 객체 자체가 null.","type":"object","additionalProperties":false,"required":["option_id","sale_price_krw","list_price_krw","discount_pct"],"properties":{"option_id":{"description":"대표 opt_ ID.","type":"string","pattern":"^opt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"sale_price_krw":{"description":"그 옵션의 판매가. 0 이상.","type":"integer","minimum":0},"list_price_krw":{"description":"그 옵션의 정상가. null 은 정상가 미확인.","type":["integer","null"],"minimum":0},"discount_pct":{"description":"그 옵션의 할인율 정수 %. null 은 할인율 미확인.","type":["integer","null"],"minimum":0,"maximum":100}}},"Thumbnail":{"description":"목록 썸네일. 없으면 null.","type":"object","additionalProperties":false,"required":["url","width","height"],"properties":{"url":{"description":"재호스팅 이미지.","type":"string","format":"uri"},"width":{"description":"가로 픽셀. null 은 미확인.","type":["integer","null"],"minimum":1},"height":{"description":"세로 픽셀. null 은 미확인.","type":["integer","null"],"minimum":1}}},"SummaryLinks":{"description":"목록은 원문 permalink 만.","type":"object","additionalProperties":false,"required":["original"],"properties":{"original":{"description":"출처 게시물 permalink.","type":"string","format":"uri"}}},"EventSummary":{"description":"목록 고정 행. public_id 는 두지 않고 id 만 쓴다. fields 로 고르거나 줄이지 않는다. 구매할 수 있는 대표 후보가 없으면 representative 는 null.","type":"object","additionalProperties":false,"required":["id","status","category","title","brand","seller","representative","starts_at","ends_at","thumbnail","links","updated_at"],"properties":{"id":{"description":"evt_ 와 UUID v4.","type":"string","pattern":"^evt_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"status":{"description":"공개 상태.","allOf":[{"$ref":"#/components/schemas/PublicStatus"}]},"category":{"description":"하위 분류.","allOf":[{"$ref":"#/components/schemas/Category"}]},"title":{"description":"제품·구성 이름. 200자 이하.","type":"string","minLength":1,"maxLength":200},"brand":{"description":"브랜드. null 은 미확인.","anyOf":[{"$ref":"#/components/schemas/SummaryBrand"},{"type":"null"}]},"seller":{"description":"셀러.","allOf":[{"$ref":"#/components/schemas/SummarySeller"}]},"representative":{"description":"대표 옵션 가격. null 은 후보 없음.","anyOf":[{"$ref":"#/components/schemas/SummaryRepresentative"},{"type":"null"}]},"starts_at":{"description":"시작 경계. null 은 시작 미확인.","anyOf":[{"$ref":"#/components/schemas/TimePoint"},{"type":"null"}]},"ends_at":{"description":"종료 경계. null 은 종료 미확인.","anyOf":[{"$ref":"#/components/schemas/TimePoint"},{"type":"null"}]},"visible_until":{"description":"종료가 없는 period_unknown 의 목록 배타 끝. 상세와 같은 시각. 기준일이 없으면 1970-01-01T00:00:00+09:00 이고 목록에 넣지 않는다. 종료가 있는 period_unknown 과 다른 상태는 null. 없으면 옛 문서지만, 종료도 이 값도 없으면 서버는 목록에서 뺀다.","anyOf":[{"$ref":"#/components/schemas/TimePoint"},{"type":"null"}]},"apply_method":{"description":"신청 방법. 상세 Event.apply_method 와 같은 값. null 은 미확인. 없으면 옛 문서(미확인과 같이 읽는다). 대표 가격이 없을 때 원문에서 무엇을 하면 되는지 보이는 데 쓴다.","anyOf":[{"$ref":"#/components/schemas/ApplyMethod"},{"type":"null"}]},"product_types":{"description":"확인된 판매 품목의 종류 집합(1.4.0). 빈 배열은 미확인이다. 키가 없으면 옛 문서이고 미확인과 같이 읽는다. 사은품·부속품은 넣지 않는다. 세트는 구성품 종류를 모두 담는다.","type":"array","maxItems":29,"uniqueItems":true,"items":{"$ref":"#/components/schemas/ProductType"}},"primary_product_type":{"description":"대표 종류(1.4.0). 단일 품목이거나 주제품이 분명할 때만 product_types 안의 값이고, 세트·미확인은 null 이다.","anyOf":[{"$ref":"#/components/schemas/ProductType"},{"type":"null"}]},"thumbnail":{"description":"썸네일. null 은 공개 이미지 없음.","anyOf":[{"$ref":"#/components/schemas/Thumbnail"},{"type":"null"}]},"links":{"description":"원문 주소.","allOf":[{"$ref":"#/components/schemas/SummaryLinks"}]},"updated_at":{"description":"이 공개 행이 마지막으로 바뀐 KST 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"}}},"SellerPage":{"description":"셀러와 그 공구 요약. 신선도는 ItemEnvelope 에 있다.","type":"object","additionalProperties":false,"required":["seller","items","next_cursor"],"properties":{"seller":{"description":"셀러.","allOf":[{"$ref":"#/components/schemas/Seller"}]},"items":{"description":"이 셀러의 공구 요약.","type":"array","items":{"$ref":"#/components/schemas/EventSummary"}},"next_cursor":{"description":"다음 커서. null 은 다음이 없음(해당 없음). filter_hash 에는 이 경로와 slug 가 들어간다.","type":["string","null"],"minLength":1}}},"BrandPage":{"description":"브랜드와 그 공구 요약. 신선도는 ItemEnvelope 에 있다.","type":"object","additionalProperties":false,"required":["brand","items","next_cursor"],"properties":{"brand":{"description":"브랜드.","allOf":[{"$ref":"#/components/schemas/Brand"}]},"items":{"description":"이 브랜드의 공구 요약.","type":"array","items":{"$ref":"#/components/schemas/EventSummary"}},"next_cursor":{"description":"다음 커서. null 은 다음이 없음(해당 없음). filter_hash 에는 이 경로와 slug 가 들어간다.","type":["string","null"],"minLength":1}}},"Digest":{"description":"KST 오늘의 짧은 묶음 본문. 신선도는 ItemEnvelope 에 있다.","type":"object","additionalProperties":false,"required":["date_kst","headline_ko","items"],"properties":{"date_kst":{"description":"오늘 날짜. KST 달력 기준 YYYY-MM-DD.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"headline_ko":{"description":"사실 한 줄. 80자 이하.","type":"string","maxLength":80},"items":{"description":"오늘 보여 줄 소수 공구 요약.","type":"array","items":{"$ref":"#/components/schemas/EventSummary"}}}},"ItemEnvelope":{"description":"상세 응답. 공구·셀러·브랜드·오늘 묶음이 같은 신선도 칸을 쓴다.","type":"object","additionalProperties":false,"required":["as_of","generation","stale","sync_token","item"],"properties":{"as_of":{"description":"이 본문을 만든 스냅샷 시각.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?\\+09:00$"},"generation":{"description":"스냅샷 세대 ID.","type":"string","minLength":1,"maxLength":80},"stale":{"description":"갱신에 실패해 이전 세대를 주면 true. 진행 중 확정으로 쓰지 않는다.","type":"boolean"},"sync_token":{"description":"전체 동기화 뒤 /v1/changes 의 since 로 쓰는 불투명 배타 토큰.","type":"string","minLength":1,"maxLength":2000},"item":{"description":"경로별 본문. 공구는 Event, 셀러는 SellerPage, 브랜드는 BrandPage, 오늘은 Digest.","oneOf":[{"$ref":"#/components/schemas/Event"},{"$ref":"#/components/schemas/SellerPage"},{"$ref":"#/components/schemas/BrandPage"},{"$ref":"#/components/schemas/Digest"}]}}}}},"x-mcp":{"url":"https://hotinbeauty.com/mcp","transport":"streamable-http"}}