상세 지표 수집

모든 요청에 ADMIN 권한의 액세스 토큰이 필요합니다. 성공 응답은 Python의 JSON 객체를 그대로 반환하며 ApiResponse.data로 감싸지 않습니다.

HTTP 요청

POST /ai/admin/tiktok-hashtag/enrich/{runId}
Authorization: Bearer {access_token}
Content-Type: application/json

이름	타입	필수	설명
`runId`	String (UUID)	예	계정 발견 시작의 응답에서 받은 실행 ID

{
  "minFollowers": 1000,
  "limit": 100
}

minFollowers는 0~~10,000,000, 기본 1,000입니다. limit는 0~~100,000, 기본 0이며, 0은 전체 대상을 의미합니다. 본문을 {}로 보내면 이 기본값을 사용합니다.

발견 단계와 별도로 계정별 최근 게시물·평균 지표를 채웁니다. 계정마다 추가 API 호출이 발생하므로 프론트에서 실행 조건과 예정 인원을 확인할 수 있게 구성합니다.

{
  "runId": "04f8e5cb-d3ea-4d72-88a8-e9ebdaac3a16",
  "executionName": "projects/.../executions/...",
  "targetCount": 20
}

targetCount는 이번 실행의 예정 대상 수입니다. 진행 결과는 상태 조회의 enrichStatus와 enrichedCreators에서 확인합니다.

요청 필드	타입	필수	범위·기본값
`minFollowers`	Integer	아니오	0~10,000,000, 기본 1,000
`limit`	Integer	아니오	0~100,000, 기본 0. 0은 전체 대상

상태 조회에 동일한 minFollowers를 전달해 대상 수를 확인합니다. 계정 발견이 완료되어도 enrichStatus가 진행 중이면 상태 조회를 계속합니다.

아래 상태는 실제 HTTP 상태 코드입니다. 오류 본문은 {"detail":"..."} 형식이며, Python 입력 검증 오류의 detail은 배열일 수 있습니다. 로그인·권한 오류는 기존 공통 관리자 인증 응답을 따릅니다.

쓰기 요청은 자동 재시도하지 않습니다. 응답을 받지 못해도 요청이 반영됐을 수 있으므로 상태를 먼저 확인합니다.