> 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"
    }
  ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://malgn.gitbook.io/cloud/api/get-course-info.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.