Glowb Dev Docs
Admin APIDM 자동화

잡 목록 조회

DM 자동화 실행 이력을 최신순으로 조회합니다. 과거 결과 재다운로드에 사용합니다.

잡 목록 조회

DM 자동화 실행 이력을 최신순으로 조회합니다. 수집과 모집메세지 생성이 같은 목록에 함께 나옵니다.

HTTP 요청

GET /ai/admin/dm-automation/jobs?page=0&size=20&jobType=COLLECT&status=COMPLETED
Authorization: Bearer {access_token}

Query Parameters

파라미터타입필수기본값설명
pageInteger아니오0페이지 번호 (0부터)
sizeInteger아니오20페이지 크기
jobTypeString아니오전체COLLECT 또는 GENERATE_MESSAGE
statusString아니오전체QUEUED / RUNNING / COMPLETED / FAILED

정렬은 createdAt 내림차순(최근 실행 순) 고정입니다.

응답

성공 응답

{
  "status": 200,
  "code": null,
  "message": "조회 성공",
  "data": {
    "content": [
      {
        "jobId": 43,
        "jobType": "GENERATE_MESSAGE",
        "status": "COMPLETED",
        "requestedBy": "admin01",
        "resultFileName": "dm_message_result.xlsx",
        "downloadUrl": "https://storage.googleapis.com/glowb-input/dm-automation/GENERATE_MESSAGE/43/result_dm_message_result.xlsx",
        "rowCount": 218,
        "errorCount": 0,
        "createdAt": "2026-07-23T15:20:03",
        "completedAt": "2026-07-23T15:20:04"
      },
      {
        "jobId": 42,
        "jobType": "COLLECT",
        "status": "COMPLETED",
        "requestedBy": "admin01",
        "resultFileName": "dm_collect_result.xlsx",
        "downloadUrl": "https://storage.googleapis.com/glowb-input/dm-automation/COLLECT/9f2c7b1e4a5d4c8e9b0a1f2e3d4c5b6a/result_dm_collect_result.xlsx",
        "rowCount": 218,
        "errorCount": 3,
        "createdAt": "2026-07-23T14:02:11",
        "completedAt": "2026-07-23T14:05:47"
      }
    ],
    "totalElements": 2,
    "totalPages": 1,
    "number": 0,
    "size": 20
  }
}

응답 필드

필드타입설명
jobIdLong잡 번호
jobTypeStringCOLLECT / GENERATE_MESSAGE
statusString잡 상태
requestedByString요청한 관리자 ID
resultFileNameString결과 파일명. COMPLETED가 아니면 null
downloadUrlString결과 엑셀 공개 URL. COMPLETED가 아니면 null
rowCountInteger처리 행 수. COMPLETED가 아니면 null
errorCountInteger실패 행 수. COMPLETED가 아니면 null
createdAtLocalDateTime잡 생성 시각
completedAtLocalDateTime종료 시각

목록 항목에는 inputFileNameerrorMessage가 없습니다. 실패 사유를 보려면 잡 상세 조회를 쓰세요.

에러 응답

HTTP 상태는 항상 200이며, 아래 코드는 응답 본문의 status 값입니다.

본문 status설명
401인증 실패
403ADMIN 권한 필요

API 테스트

On this page