> For the complete documentation index, see [llms.txt](https://malgn.gitbook.io/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://malgn.gitbook.io/cloud/api/get-completion-list.md).

# 수료 정보 목록 조회

> **문서 정보**
>
> * **버전:** 1.0
> * **작성일:** 2019.07.03

***

### 1. 소개

맑은이러닝을 이용하여 수료를 완료한 수강생의 정보를 기간을 기준으로 검색하여 일별출력하는 API입니다.

***

### 2. API 연결 스펙

<table><thead><tr><th width="223">구분</th><th width="336">정보</th></tr></thead><tbody><tr><td><strong>URL</strong></td><td><code>[domain]/api/complete_user_list.jsp</code></td></tr><tr><td><strong>Method</strong></td><td><code>POST</code> 또는 <code>GET</code></td></tr><tr><td><strong>Response Type</strong></td><td><code>application/json</code></td></tr><tr><td><strong>Encoding</strong></td><td><code>UTF-8</code></td></tr></tbody></table>

***

### 3. Request Parameters (요청 변수)

<table data-search="true"><thead><tr><th width="109" align="center">파라미터</th><th width="112" align="center">필수</th><th width="138">포맷</th><th>정의</th></tr></thead><tbody><tr><td align="center"><strong>token</strong></td><td align="center"><strong>Y</strong></td><td>string</td><td>API 엑세스 토큰을 지정합니다.</td></tr><tr><td align="center"><strong>sdate</strong></td><td align="center"><strong>Y</strong></td><td>YYYYMMDD</td><td>수료일 검색 범위 시작일</td></tr><tr><td align="center"><strong>edate</strong></td><td align="center"><strong>Y</strong></td><td>YYYYMMDD</td><td>수료일 검색 범위 종료일</td></tr><tr><td align="center"><strong>cid</strong></td><td align="center">N</td><td>integer</td><td>과정아이디를 지정합니다. (지정하지 않으면 모든 과정 검색)</td></tr><tr><td align="center"><strong>uid</strong></td><td align="center">N</td><td>integer</td><td>회원아이디를 지정합니다. (지정하지 않으면 모든 회원 검색)</td></tr><tr><td align="center"><strong>status</strong></td><td align="center">N</td><td>string</td><td>수강생의 상태를 지정합니다. (지정하지 않으면 모든 수강생 검색)<br><br><strong>[지정 가능 값]</strong><br>• <code>1</code> : 정상<br>• <code>0</code> : 승인대기<br>• <code>2</code> : 입금대기<br>• <code>3</code> : 취소요청<br>• <code>-4</code> : 취소승인</td></tr></tbody></table>

***

### 4. Response (응답 구조)

#### 공통 응답 필드

<table data-search="true"><thead><tr><th width="172">값</th><th width="159">포맷</th><th>정의</th></tr></thead><tbody><tr><td><strong>ret_code</strong></td><td>string</td><td>호출 결과 코드</td></tr><tr><td><strong>ret_msg</strong></td><td>string</td><td>호출 결과 메시지</td></tr><tr><td><strong>ret_size</strong></td><td>integer</td><td>응답 데이터의 개수</td></tr><tr><td><strong>ret_data</strong></td><td>array</td><td>응답 데이터 배열 (수료일별 배열)</td></tr></tbody></table>

#### ret\_data 내부 구조 (수료일별 배열)

<table data-search="true"><thead><tr><th width="171">값</th><th width="175">포맷</th><th>정의</th></tr></thead><tbody><tr><td><strong>sub_size</strong></td><td>integer</td><td>수료일별 수강생 데이터의 개수</td></tr><tr><td><strong>sub_data</strong></td><td>array</td><td>수료일별 수강생 상세 데이터 배열 (하단 테이블 참고)</td></tr></tbody></table>

#### sub\_data (수강생 상세 데이터 배열) 상세 필드

<table><thead><tr><th width="175">값</th><th width="174">포맷</th><th>정의</th></tr></thead><tbody><tr><td><strong>id</strong></td><td>integer</td><td>수강생아이디</td></tr><tr><td><strong>course_id</strong></td><td>integer</td><td>과정아이디</td></tr><tr><td><strong>year</strong></td><td>integer</td><td>과정년도</td></tr><tr><td><strong>step</strong></td><td>integer</td><td>과정기수</td></tr><tr><td><strong>onoff_type</strong></td><td>string</td><td>과정구분 <br>(N:온라인 / F:집합 / B:혼합 / P:패키지)</td></tr><tr><td><strong>course_type</strong></td><td>string</td><td>과정기간구분 (A:상시 / R:정규)</td></tr><tr><td><strong>course_nm</strong></td><td>string</td><td>과정명</td></tr><tr><td><strong>credit</strong></td><td>integer</td><td>인정학점</td></tr><tr><td><strong>user_id</strong></td><td>integer</td><td>회원아이디</td></tr><tr><td><strong>login_id</strong></td><td>string</td><td>로그인아이디</td></tr><tr><td><strong>user_nm</strong></td><td>string</td><td>회원명</td></tr><tr><td><strong>start_date</strong></td><td>YYYYMMDD</td><td>학습시작일</td></tr><tr><td><strong>end_date</strong></td><td>YYYYMMDD</td><td>학습종료일</td></tr><tr><td><strong>total_score</strong></td><td>integer</td><td>총점</td></tr><tr><td><strong>progress_ratio</strong></td><td>double</td><td>진도율</td></tr><tr><td><strong>complete_no</strong></td><td>string</td><td>수료번호 <br>(과정년도-과정기수-수강생아이디)</td></tr><tr><td><strong>complete_date</strong></td><td>YYYYMMDD</td><td>수료일</td></tr><tr><td><strong>complete_time</strong></td><td>YYYYMMDDHHIISS</td><td>수료일시</td></tr><tr><td><strong>reg_date</strong></td><td>YYYYMMDDHHIISS</td><td>등록일시</td></tr><tr><td><strong>status</strong></td><td>string</td><td>수강생 상태</td></tr></tbody></table>

***

### 5. 응답 예시 (JSON Example)

```json
{
  "ret_code": "000",
  "ret_msg": "success",
  "ret_size": 1,
  "ret_data": [
    {
      "20190703": {
        "sub_size": 1,
        "sub_data": [
          {
            "id": 1004,
            "course_id": 99,
            "year": 2019,
            "step": 1,
            "onoff_type": "N",
            "course_type": "R",
            "course_nm": "맑은이러닝 서비스 활용법",
            "credit": 2,
            "user_id": 501,
            "login_id": "malgn_user",
            "user_nm": "홍길동",
            "start_date": "20190601",
            "end_date": "20190630",
            "total_score": 90,
            "progress_ratio": 100.0,
            "complete_no": "2019-1-1004",
            "complete_date": "20190703",
            "complete_time": "20190703153022",
            "reg_date": "20190601090000",
            "status": "1"
          }
        ]
      }
    }
  ]
}
```
