Main APIData Job API
POST /ai/data/jobs/start
데이터 수집 배치 시작
데이터 수집 배치 시작
Python 서버에 장시간 배치 작업을 위임하고 완료 콜백을 설정합니다.
| 항목 | 값 |
|---|---|
| 메서드 | POST |
| 경로 | /ai/data/jobs/start |
| 인증 | 필요 |
| Content-Type | application/json |
요청
POST /ai/data/jobs/start
Authorization: Bearer {access_token}
Content-Type: application/jsonRequest Body
{
"tags": ["#travel", "#korea"],
"country": "KR",
"category": "TRAVEL",
"isAi": true,
"minFollower": 5000,
"priority": "high"
}Request Body 스키마 (DataJobRequest)
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
tags | string[] | 아니오 | 검색 태그 목록 (예: ["#travel"]) |
country | string | 아니오 | 국가 코드 (예: KR) |
category | string | 아니오 | 카테고리 (예: TRAVEL) |
isAi | boolean | 아니오 | AI 분석 여부. 기본값: true |
minFollower | int | 아니오 | 최소 팔로워 수 (예: 5000) |
priority | string | 아니오 | 우선순위 |
응답
성공 응답 (200 OK)
{
"umbrella_job_id": "abc123-def456",
"group_id": "group-789xyz",
"queue": "data-collection",
"priority": "high",
"callback_enabled": true
}Response 스키마 (DataJobStartResponse)
| 필드명 | 타입 | 설명 |
|---|---|---|
umbrella_job_id | string | 상위 작업 ID |
group_id | string | Python 서버 반환 그룹 ID |
queue | string | 대상 큐 이름 |
priority | string | 우선순위 |
callback_enabled | boolean | 콜백 활성화 여부 |
사용 예시
curl -X POST https://api.glowb.io/ai/data/jobs/start \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"tags": ["#beauty", "#skincare"],
"country": "KR",
"category": "BEAUTY",
"minFollower": 10000
}'