Admin API틱톡 해시태그 수집
개요
틱톡 해시태그 수집 관리자 API 흐름과 공통 설정
해시태그로 틱톡 크리에이터를 발견하고, 발견한 계정의 게시물·평균 지표를 추가 수집하는 관리자 API입니다. Java 서버는 관리자 인증과 입력 검증을 처리하고 Python 수집기에 요청을 전달합니다. 프론트 화면은 별도로 구현해야 합니다.
API 목록
| 메서드 | API 문서 | 경로 |
|---|---|---|
| POST | 계정 발견 시작 | /ai/admin/tiktok-hashtag/start |
| GET | 상태 조회 | /ai/admin/tiktok-hashtag/status/{runId} |
| POST | 상세 지표 수집 | /ai/admin/tiktok-hashtag/enrich/{runId} |
| POST | 계정 발견 중단 | /ai/admin/tiktok-hashtag/stop/{runId} |
각 API의 요청 파라미터, 응답, 오류와 테스트 도구는 해당 페이지에 있습니다.
공통 인증·응답
모든 요청에 ADMIN 권한의 액세스 토큰이 필요합니다.
성공 응답은 Python의 JSON 객체를 그대로 반환하며 ApiResponse.data로 감싸지 않습니다.
관리자 토큰은 Authorization: Bearer <access_token> 헤더로 전달합니다.
JSON 요청에는 Content-Type: application/json을 사용합니다.
연동 순서
- 시작 API로 계정 발견을 요청하고 응답의
runId를 보관합니다. - 상태 조회에서 계정 발견 및 상세 수집의 진행 상황을 확인합니다.
- 추가 지표가 필요한 경우 팔로워 하한·대상 수를 지정해 상세 수집을 시작합니다.
- 계정 발견 중단이 필요한 경우 중단 API를 호출합니다. 상세 수집은 중단하지 않습니다.
저장·환경 설정
- Java에 별도 실행 이력 테이블을 추가하지 않습니다. 계정·지표와 실행 상태는 Python에서 관리합니다.
- 현재 Python API에는 실행 목록·실행별 계정 목록·CSV 다운로드가 없습니다. 프론트에서 실행 ID를 보관해야 다시 조회할 수 있습니다.
- Python 호출 대상은 기존
python.api.new-url설정을 사용하며, 그 뒤에/api/tiktok-hashtag/...를 붙입니다. - 운영 설정은 프로덕션 Python 서버, 테스트 설정은 테스트 Python 서버를 가리켜야 합니다. 이 변경은 환경 설정을 덮어쓰지 않습니다.
- 신규 DB 마이그레이션이나 환경 변수는 필요하지 않습니다.