[v2.0] API 명세서

# API 명세서 v2.0 > 프린트타운 시스템 API 문서 ## ? 개요 ### 기본 정보 - **Base URL**: `http://custemplate` - **API Version**: 2.0 - **Protocol**: HTTP/HTTPS - **Encoding**: UTF-8 - **Response Format**: JSON, HTML ### 주요 변경사항 (v1.0 → v2.0) - Bootstrap 4 기반 응답 HTML 구조 변경 - 마크다운 컨텐츠 인코딩 방식 개선 (rawurlencode) - 에디터 플러그인 시스템 추가 --- ## ? 인증 ### 세션 기반 인증 ```php $_SESSION["ss_mb_id"] // 회원 ID $is_member // 로그인 여부 $is_admin // 관리자 권한 (super|group|board) ``` --- ## ? 게시판 API ### 1. 게시글 목록 조회 #### Request ```http GET /bbs/board.php?bo_table={board_id} ``` **Parameters** | Name | Type | Required | Description | |------|------|----------|-------------| | bo_table | string | ✅ | 게시판 ID (free, p_docs, qa) | | page | integer | ❌ | 페이지 번호 (default: 1) | | sca | string | ❌ | 카테고리 필터 | | stx | string | ❌ | 검색어 | | sfl | string | ❌ | 검색 필드 | #### Response (HTML - Bootstrap 4) ```html ... ``` ### 2. 게시글 작성 #### Request ```http POST /bbs/write_update.php Content-Type: multipart/form-data ``` **Parameters** | Name | Type | Required | Description | |------|------|----------|-------------| | bo_table | string | ✅ | 게시판 ID | | wr_subject | string | ✅ | 제목 | | wr_content | string | ✅ | 내용 (Markdown/HTML) | | ca_name | string | ❌ | 카테고리 | | bf_file[] | file | ❌ | 첨부파일 | --- ## ? Markdown Editor API ###설정 ```php // 게시판 설정 bo_select_editor = "markdown" ``` ### Functions **editor_html()** ```php function editor_html($id, $content, $is_dhtml_editor=true) // wr_content용: Toast UI Editor 렌더링 // 기타 필드: 일반 textarea ``` ### Toast UI 초기화 ```javascript const editor = new toastui.Editor({ el: document.querySelector("#toast_editor_wr_content"), height: "500px", initialEditType: "markdown", previewStyle: "vertical", initialValue: content }); ``` --- ## ? 데이터베이스 ### g5_write_p_docs ```sql CREATE TABLE g5_write_p_docs ( wr_id INT PRIMARY KEY AUTO_INCREMENT, ca_name VARCHAR(255), -- 카테고리 wr_subject VARCHAR(255), -- 제목 wr_content TEXT, -- UTF-8 인코딩 wr_datetime DATETIME, wr_hit INT DEFAULT 0, mb_id VARCHAR(20) ); ``` ### g5_board ```sql CREATE TABLE g5_board ( bo_table VARCHAR(20) PRIMARY KEY, bo_subject VARCHAR(255), bo_skin VARCHAR(255), bo_select_editor VARCHAR(50) -- NEW: 에디터 선택 ); ``` --- ## ? 에러 코드 | Code | Message | Description | |------|---------|-------------| | 200 | OK | 정상 처리 | | 400 | Bad Request | 잘못된 요청 | | 401 | Unauthorized | 인증 필요 | | 403 | Forbidden | 권한 없음 | | 404 | Not Found | 리소스 없음 | --- ## ? 예제 ### Markdown 게시글 작성 ```javascript const formData = new FormData(); formData.append("bo_table", "p_docs"); formData.append("wr_subject", "테스트 문서"); formData.append("wr_content", editor.getMarkdown()); fetch("/bbs/write_update.php", { method: "POST", body: formData }); ``` --- **Last Updated**: 2026-01-01