Admin API틱톡 해시태그 수집
계정 발견 중단
POST /ai/admin/tiktok-hashtag/stop/{runId}
모든 요청에 ADMIN 권한의 액세스 토큰이 필요합니다.
성공 응답은 Python의 JSON 객체를 그대로 반환하며 ApiResponse.data로 감싸지 않습니다.
HTTP 요청
POST /ai/admin/tiktok-hashtag/stop/{runId}
Authorization: Bearer {access_token}경로 파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
runId | String (UUID) | 예 | 계정 발견 시작의 응답에서 받은 실행 ID |
요청 본문은 없습니다. 현재 태그 처리가 끝나면 중단하며, 이미 저장된 결과는 유지합니다. 상세 지표 수집을 중단하는 API는 아닙니다.
응답 (200 OK)
{
"runId": "04f8e5cb-d3ea-4d72-88a8-e9ebdaac3a16",
"status": "CANCELLED"
}응답 필드와 중단 확인
| 필드 | 타입 | 설명 |
|---|---|---|
runId | String (UUID) | 중단 요청한 실행 ID |
status | String | CANCELLED |
이 응답은 중단 요청이 저장됐다는 의미입니다. 현재 처리 중인 태그의 작업이 즉시 종료된다는 의미는 아닙니다. 진행 상황은 상태 조회에서 확인합니다.
오류 응답
아래 상태는 실제 HTTP 상태 코드입니다. 오류 본문은 {"detail":"..."} 형식이며,
Python 입력 검증 오류의 detail은 배열일 수 있습니다. 로그인·권한 오류는 기존 공통 관리자 인증 응답을 따릅니다.
| HTTP 상태 | 의미 |
|---|---|
400 | 잘못된 UUID |
404 | 실행 없음 |
422 | Python 입력 검증 실패 |
502 | Python 요청·응답 처리 실패 |
504 | 통신 시간 초과·응답 유실 |
쓰기 요청은 자동 재시도하지 않습니다. 응답을 받지 못해도 요청이 반영됐을 수 있으므로 상태를 먼저 확인합니다.