COCOBOSS API

콘텐츠 생성, 재생성, WordPress 발행, 내부링크 관리, Google 연동을 처리하는 운영용 API입니다. 일반 방문자용 사이트가 아니라 운영자와 개발자를 위한 업무 화면입니다.

API 문서 Swagger UI에서 요청과 응답을 바로 테스트할 수 있습니다. 문서 보기 ReDoc 형식으로 엔드포인트를 차분하게 읽을 수 있습니다. 상태 확인 /health로 현재 API 상태를 간단히 확인합니다.

주요 용도

사용 방법

  1. API 문서로 이동합니다.
  2. 원하는 API를 펼친 뒤 Try it out 버튼을 누릅니다.
  3. Edit Value 영역에 JSON 값을 입력합니다.
  4. Execute를 눌러 요청을 실행합니다.
  5. 아래 Response body에서 결과를 확인합니다.

현재는 관리자 입력 폼이 아니라 Swagger 기반 운영 방식입니다. 즉, 버튼형 관리페이지가 아니라 JSON 요청으로 작업하는 구조입니다.

자주 쓰는 예시

1. 주제 만들기

POST /api/v1/topics

{
  "keyword": "장마철 신발 냄새 제거",
  "intent": "INFO",
  "product_code": "COCOSHU",
  "priority_score": 50
}

2. 네이버 글 가져오기

POST /api/v1/import/naver

{
  "source_url": "https://blog.naver.com/cocoboss_deodorant/223946527926",
  "product_code": "COCOSHU",
  "import_mode": "hybrid",
  "stage": "DRAFT",
  "create_topic": true
}

3. 본문 재생성

POST /api/v1/content/regenerate

{
  "content_id": 12,
  "template_version": "v1.4",
  "cta_variant": "A"
}

4. WordPress 발행

POST /api/v1/publish/wordpress

{
  "content_id": 12
}

운영 메모