> 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-course-info.md).

# 과정 정보 조회

> **문서 정보**
>
> * **버전:** 1.2
> * **작성일:** 2016.11.07

***

### 1. 소개

맑은LMS에 개설된 과정의 정보를 조회하는 API입니다.

***

### 2. API 연결 스펙

<table><thead><tr><th width="215">구분</th><th width="300">정보</th></tr></thead><tbody><tr><td><strong>URL</strong></td><td><code>[domain]/api/course_api.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> 또는 <code>text/xml</code></td></tr><tr><td><strong>Encoding</strong></td><td><code>UTF-8</code></td></tr></tbody></table>

***

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

<table><thead><tr><th width="104">파라미터</th><th width="85" align="center">필수</th><th width="98">포맷</th><th>정의</th></tr></thead><tbody><tr><td><strong>token</strong></td><td align="center"><strong>Y</strong></td><td>string</td><td>API 엑세스 토큰을 지정합니다.</td></tr><tr><td><strong>ctype</strong></td><td align="center">N</td><td>string</td><td>과정의 기간구분을 지정합니다.<br><br><strong>[지정 가능 값]</strong><br>• <code>A</code> : 상시<br>• <code>R</code> : 정규</td></tr><tr><td><strong>otype</strong></td><td align="center">N</td><td>string</td><td>과정의 수강구분을 지정합니다.<br><br><strong>[지정 가능 값]</strong><br>• <code>N</code> : 온라인<br>• <code>F</code> : 집합(오프라인)<br>• <code>B</code> : 혼합<br>• <code>P</code> : 패키지</td></tr><tr><td><strong>idx</strong></td><td align="center">N</td><td>string</td><td>과정아이디들을 ', (콤마)'로 구분 지정하여 특정 과정들을 조회합니다.</td></tr><tr><td><strong>id</strong></td><td align="center">N</td><td>integer</td><td>과정아이디를 지정하여 특정 과정을 조회합니다.</td></tr><tr><td><strong>cid</strong></td><td align="center">N</td><td>integer</td><td>카테고리아이디를 지정하여 하위 과정을 조회합니다.</td></tr><tr><td><strong>year</strong></td><td align="center">N</td><td>yyyy</td><td>과정의 개설년도를 지정합니다.</td></tr><tr><td><strong>step</strong></td><td align="center">N</td><td>integer</td><td>과정의 기수를 지정합니다.</td></tr><tr><td><strong>name</strong></td><td align="center">N</td><td>string</td><td>과정명을 검색합니다.</td></tr><tr><td><strong>sale</strong></td><td align="center">N</td><td>Y or N</td><td>과정의 판매상태를 지정합니다.</td></tr><tr><td><strong>display</strong></td><td align="center">N</td><td>Y or N</td><td>과정의 노출상태를 지정합니다.</td></tr><tr><td><strong>etc1</strong></td><td align="center">N</td><td>string</td><td>기타1 필드의 내용을 검색합니다.</td></tr><tr><td><strong>etc2</strong></td><td align="center">N</td><td>string</td><td>기타2 필드의 내용을 검색합니다.</td></tr><tr><td><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> : 중지</td></tr><tr><td><strong>format</strong></td><td align="center">N</td><td>json or xml</td><td>출력 형식을 지정합니다. <br>(지정하지 않으면 json으로 출력됩니다.)</td></tr></tbody></table>

***

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

#### 공통 응답 필드

<table data-search="true"><thead><tr><th width="127">값</th><th width="133">포맷</th><th width="181">정의</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><thead><tr><th width="152">값</th><th width="124">포맷</th><th width="351">정의</th></tr></thead><tbody><tr><td><strong>_ord</strong></td><td>integer</td><td>데이터 순번</td></tr><tr><td><strong>_first</strong></td><td>boolean</td><td>첫 번째 데이터 여부</td></tr><tr><td><strong>_last</strong></td><td>boolean</td><td>마지막 데이터 여부</td></tr><tr><td><strong>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>course_type</strong></td><td>string</td><td>기간구분 (A: 상시 / R: 정규)</td></tr><tr><td><strong>course_file_url</strong></td><td>string</td><td>과정이미지 URL</td></tr><tr><td><strong>onoff_type</strong></td><td>string</td><td>수강구분 (N: 온라인 / F: 오프라인 / B: 혼합 / P: 패키지)</td></tr><tr><td><strong>course_nm</strong></td><td>string</td><td>과정명</td></tr><tr><td><strong>request_sdate</strong></td><td>YYYYMMDD</td><td>수강신청시작일</td></tr><tr><td><strong>request_edate</strong></td><td>YYYYMMDD</td><td>수강신청종료일</td></tr><tr><td><strong>study_sdate</strong></td><td>YYYYMMDD</td><td>(정규과정)학습시작일</td></tr><tr><td><strong>study_edate</strong></td><td>YYYYMMDD</td><td>(정규과정)학습종료일</td></tr><tr><td><strong>lesson_day</strong></td><td>integer</td><td>(상시과정)학습일</td></tr><tr><td><strong>lesson_time</strong></td><td>integer</td><td>학습시수</td></tr><tr><td><strong>list_price</strong></td><td>integer</td><td>정가</td></tr><tr><td><strong>price</strong></td><td>integer</td><td>판매가</td></tr><tr><td><strong>credit</strong></td><td>integer</td><td>인정학점</td></tr><tr><td><strong>subtitle</strong></td><td>string</td><td>홍보문구</td></tr><tr><td><strong>content1_title</strong></td><td>string</td><td>설명1 제목</td></tr><tr><td><strong>content1</strong></td><td>string</td><td>설명1 내용</td></tr><tr><td><strong>content2_title</strong></td><td>string</td><td>설명2 제목</td></tr><tr><td><strong>content2</strong></td><td>string</td><td>설명2 내용</td></tr><tr><td><strong>etc1</strong></td><td>string</td><td>기타1 내용</td></tr><tr><td><strong>etc2</strong></td><td>string</td><td>기타2 내용</td></tr><tr><td><strong>sale_yn</strong></td><td>Y or N</td><td>판매여부</td></tr><tr><td><strong>display_yn</strong></td><td>Y or N</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": [
    {
      "_ord": 1,
      "_first": true,
      "_last": true,
      "id": 1004,
      "year": 2016,
      "step": 1,
      "course_type": "R",
      "course_file_url": "[https://domain.com/files/course_image.png](https://domain.com/files/course_image.png)",
      "onoff_type": "N",
      "course_nm": "맑은LMS 스마트 과정 구축 가이드",
      "request_sdate": "20161101",
      "request_edate": "20161130",
      "study_sdate": "20161201",
      "study_edate": "20161231",
      "lesson_day": 30,
      "lesson_time": 16,
      "list_price": 50000,
      "price": 45000,
      "credit": 2,
      "subtitle": "스마트한 러닝 인프라 구축의 시작",
      "content1_title": "과정 개요",
      "content1": "이 과정은 맑은LMS를 활용한 최적의 학습 운영 기법을 배웁니다.",
      "content2_title": "기대 효과",
      "content2": "효율적인 시스템 관리 능력을 배양할 수 있습니다.",
      "etc1": "선착순 모집",
      "etc2": "교재 무료 제공",
      "sale_yn": "Y",
      "display_yn": "Y",
      "status": "1"
    }
  ]
}
```
