Glowb Dev Docs
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}

경로 파라미터

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

요청 본문은 없습니다. 현재 태그 처리가 끝나면 중단하며, 이미 저장된 결과는 유지합니다. 상세 지표 수집을 중단하는 API는 아닙니다.

응답 (200 OK)

{
  "runId": "04f8e5cb-d3ea-4d72-88a8-e9ebdaac3a16",
  "status": "CANCELLED"
}

응답 필드와 중단 확인

필드타입설명
runIdString (UUID)중단 요청한 실행 ID
statusStringCANCELLED

이 응답은 중단 요청이 저장됐다는 의미입니다. 현재 처리 중인 태그의 작업이 즉시 종료된다는 의미는 아닙니다. 진행 상황은 상태 조회에서 확인합니다.

오류 응답

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

HTTP 상태의미
400잘못된 UUID
404실행 없음
422Python 입력 검증 실패
502Python 요청·응답 처리 실패
504통신 시간 초과·응답 유실

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

API 테스트

On this page