Admin APIAdmin All Pending Participants API
Admin All Pending Participants API
여러 캠페인의 미처리 대상자를 한 번에 통합 조회하는 API
Admin All Pending Participants API
여러 캠페인을 한 번에 훑어 미처리 대상자(미서명/미제출/미등록 등)를 통합 조회하기 위한 API입니다. 단일 캠페인만 조회할 때는 Admin Pending Participants API 를 사용하세요.
Base URL: /ai/admin/pending-participants
관리자 권한 전용. 응답 데이터 규모가 커질 수 있으니 필요시 campaignNos, overdueStatuses 로 범위를 제한해 호출하세요.
엔드포인트 목록
| 메서드 | 경로 | 설명 |
|---|---|---|
GET | / | 전체/복수 캠페인 미처리 대상자 목록 |
GET | /summary | 전체/복수 캠페인 케이스별 건수 |
단일 캠페인 API 와의 차이
| 항목 | 단일 (/campaigns/{campaignNo}/pending-participants) | 전체 (/pending-participants) |
|---|---|---|
| 캠페인 지정 방식 | campaignNo path 파라미터 (필수) | campaignNos query 파라미터 (옵션) |
| 미지정 시 동작 | 404 (path 가 맞지 않음) | 활성(state=true) 캠페인 전체 대상 |
| 응답 스키마 | 동일 | 동일 (각 row 에 campaignNo, campaignTitle 포함) |
| 연락 이력/메모 CRUD | 이쪽에서 제공 | 미제공 (단일 API 사용) |
연락 이력 추가·조회, 메모 CRUD 는 단일 캠페인 API(.../campaigns/{campaignNo}/pending-participants/{applicationId}/...)에서만 제공됩니다.
공통 쿼리 파라미터
목록·요약 모두 아래 파라미터를 공유합니다. 자세한 enum 정의는 단일 캠페인 API 의 index 를 참고하세요.
| 파라미터 | 타입 | 기본 | 설명 |
|---|---|---|---|
campaignNos | List<Integer> | — | 복수 지정 가능 (?campaignNos=1&campaignNos=2). 미지정 시 활성 캠페인 전체. |
cases | List<PendingCase> | 전부 | 케이스 필터 |
overdueStatuses | List<OverdueStatus> | 전부 | OVERDUE/TODAY/UPCOMING/NO_DEADLINE |
contactFilter | ContactFilter | ALL | CONTACTED / NOT_CONTACTED 필터 |
search | string | — | 닉네임/이메일/전화 like |
성능 특성
쿼리 수는 총 6~7개로 고정됩니다 (캠페인 수와 무관):
- 활성 캠페인 조회 or
IN필터 1회 - 캠페인 단위 계약 마감 batch 조회 1회
- 선정 완료 application + Influence fetch join 1회
- application 기반 IN 배치 5회 (contract / review+items / finalSubmission / schedule / contactLog)
결과 정렬·페이지·케이스 분류는 in-memory 로 처리되며, 선정자 총 수가 많아질 수 있으므로 기본 페이지 크기(size=20)로 조회하는 것을 권장합니다.