프론트엔드 공유용: API 변경/Deprecated 안내 (2025-12-18)

본 문서는 프론트엔드 개발자가 바로 적용할 수 있도록, 오늘 반영된 API 변경점과 Deprecated(비권장) 엔드포인트를 정리한 문서입니다.

---

1) 가장 중요한 변경: 슬롯 생성 API 단순화

신규(권장): 광고주/일반 사용자용 슬롯 생성

• POST /api/v1/slots/user/create
• 필수값은 3개만: platform, keyword, url
• platform은 id / name 모두 지원
• 예: 1 또는 "1"
• 예: "naver", "place"

요청 예시 (Swagger 기본 예제)

{
  "platform": "naver",
  "keyword": "키즈비타민",
  "url": "https://smartstore.naver.com/newdaylife/products/5091168272"
}

관리자 대리 생성

• 관리자 로그인 시 advertiser_id를 옵션으로 전달하면 해당 광고주로 생성됩니다.

---

2) user_id 기반 슬롯 API → user_id 없는 API로 전환

신규(권장): 슬롯 목록 조회 (user_id 없이)

• GET /api/v1/slots/all
• 로그인한 사용자 기준 조회

신규(권장): 슬롯 정보 일괄 수정 (user_id 없이)

• PATCH /api/v1/slots/user/batch/info
• 단일 슬롯 수정은 사용하지 않으며, batch 수정만 사용합니다.

---

3) Deprecated(비권장) 엔드포인트 목록

아래 엔드포인트는 향후 제거될 예정이므로 신규 개발에서는 사용하지 마세요.

3-1) 레거시: user_id 경로 기반 슬롯 생성/조회/수정

• POST /api/v1/accounts/{user_id}/slots/user/create
• 대체: POST /api/v1/slots/user/create
• GET /api/v1/accounts/{user_id}/slots/all
• 대체: GET /api/v1/slots/all
• PATCH /api/v1/accounts/{user_id}/slots/user/batch/info
• 대체: PATCH /api/v1/slots/user/batch/info

3-2) 테스트 슬롯 생성 (관리자)

• POST /api/v1/accounts/{user_id}/slots/admin/create_test_slots
• Deprecated (사용하지 않음)

3-3) 기간 연장(연장/일괄연장/권한별 분기) 전부 Deprecated

• POST /api/v1/accounts/{user_id}/slots/user/date/batch
• POST /api/v1/accounts/{user_id}/slots/{slot_id}/admin/date
• POST /api/v1/accounts/{user_id}/slots/admin/date/batch
• POST /api/v1/accounts/{user_id}/slots/{slot_id}/agency/date
• POST /api/v1/accounts/{user_id}/slots/agency/date/batch

---

4) 참고

• Swagger UI: /api/v1/docs
• OpenAPI JSON: /api/v1/openapi.json