Swagger + API 소개 페이지에 사용됨. Swagger 에서 일부 태그가 제거될 수 있음.
')
+ fieldRow('상세 설명', textarea(op.description.value, 'data-path="operation.description.value"', { rows: 4, placeholder: '동작, 비즈니스 규칙, 주의사항' }) + '
${state.data.tags.map(t => `
@@ -435,57 +432,147 @@
// ============================================================
// 8. Step 3 — 파라미터 / 스키마 (핵심)
// ============================================================
- function renderStep3(root) {
- // Request Body 만 접근 (파라미터 / Response / Components 미노출)
- state.step3Section = 'body';
- root.innerHTML = renderBodyTable();
- }
- function renderStep3Section() {
- // Step3 = Request Body 만. 컨테이너는 #form-content(직접). (add-row/자식추가/토글 재렌더용)
- const c = $('#form-content');
- if (!c) return;
- c.innerHTML = renderBodyTable();
+ // 서브 탭 바 (요청/응답 정보 공용)
+ function subTabBar(tabs, cur, attr) {
+ return '
'
+ + tabs.map(t => ``).join('')
+ + '
';
}
- // --- Parameters 테이블 ---
- function renderParamsTable() {
- const rows = state.data.parameters.map((p, i) => `
+ // Step 2 — 요청 정보 (Header / Parameter / Body / API 설명(HTML))
+ function renderReqInfo(root) {
+ const tab = state.reqInfoTab || 'body';
+ const tabs = [
+ { key: 'header', label: 'Header' },
+ { key: 'param', label: 'Parameter' },
+ { key: 'body', label: 'Body' },
+ { key: 'desc', label: 'API 설명(HTML)' }
+ ];
+ let body;
+ if (tab === 'header') body = renderParamsTable('header');
+ else if (tab === 'param') body = renderParamsTable('param');
+ else if (tab === 'body') body = renderBodyTable();
+ else body = card(
+ sectionTitle('요청 API 설명(HTML)', 'API 소개(설명) 페이지에 표시되는 자료입니다.') +
+ `
'
+ );
+ root.innerHTML = subTabBar(tabs, tab, 'data-reqinfo-tab') + body;
+ if (tab === 'desc') {
+ var fc = document.getElementById('form-content');
+ // 카드/탭바/툴바/여백 오버헤드를 제외해 폼 영역에 세로스크롤이 생기지 않는 높이로
+ var h = Math.max(300, (fc ? fc.clientHeight : 600) - 290);
+ initSpecEditor('#msg-editor', 'request', h);
+ }
+ }
+
+ // Step 3 — 응답 정보 (Header / Body / API 설명(HTML))
+ function renderResInfo(root) {
+ const tab = state.resInfoTab || 'body';
+ const tabs = [
+ { key: 'header', label: 'Header' },
+ { key: 'body', label: 'Body' },
+ { key: 'desc', label: 'API 설명(HTML)' }
+ ];
+ let body;
+ if (tab === 'header') body = renderResponseHeaderCard();
+ else if (tab === 'body') body = renderResponseTable();
+ else body = card(
+ sectionTitle('응답 API 설명(HTML)', 'API 소개(설명) 페이지에 표시되는 자료입니다.') +
+ `
'
+ );
+ root.innerHTML = subTabBar(tabs, tab, 'data-resinfo-tab') + body;
+ if (tab === 'desc') {
+ var fc = document.getElementById('form-content');
+ // 카드/탭바/툴바/여백 오버헤드를 제외해 폼 영역에 세로스크롤이 생기지 않는 높이로
+ var h = Math.max(300, (fc ? fc.clientHeight : 600) - 290);
+ initSpecEditor('#msg-editor', 'response', h);
+ }
+ }
+
+ // 응답 Header 카드 — 상태코드별 응답 헤더(examples.response[code].headers)
+ function renderResponseHeaderCard() {
+ const codes = Object.keys(state.data.examples.response);
+ const cur = state.responseStatusTab;
+ const curSet = state.data.examples.response[cur] || { body: '', headers: [] };
+ return card(
+ sectionTitle('응답 Header', '상태코드별 응답 헤더를 정의합니다. 추가한 상태코드는 Body/[요청/응답 샘플]과 연동됩니다.') +
+ `
+ ${codes.map(code => `
+
+ `).join('')}
+
+
` +
+ `
+
+ | name | type | description | example | |
|---|
+
+
+ ${(curSet.headers || []).map((h, i) => `
+
+ | ${input(h.name, `data-resp-header="${i}.name"`)} |
+ ${selectInput(h.type, ['string', 'integer', 'number', 'boolean'], `data-resp-header="${i}.type"`)} |
+ ${input(h.description, `data-resp-header="${i}.description"`)} |
+ ${input(h.example, `data-resp-header="${i}.example"`)} |
+ |
+
+ `).join('')}
+
+
+
+
+
`
+ );
+ }
+
+ function renderStep3Section() {
+ // add-row/자식추가/토글/탭전환 재렌더용 — 현재 스텝 폼 재렌더(활성 서브탭 유지)
+ renderForm();
+ }
+
+ // --- Parameters 테이블 (kind: 'header' = in=header / 'param' = query 전용) ---
+ function renderParamsTable(kind) {
+ const isHeader = kind === 'header';
+ const entries = state.data.parameters
+ .map((p, i) => ({ p: p, i: i }))
+ .filter(e => isHeader ? e.p.in === 'header' : e.p.in === 'query');
+ const rows = entries.map(e => {
+ const p = e.p, i = e.i;
+ return `
- | ${selectInput(p.in, ['header', 'query', 'path', 'cookie'], `data-pparam-in="${i}"`)} |
${p.name.locked ? lockedInput(p.name.value) : input(p.name.value, `data-path="parameters.${i}.name.value"`)} |
+ ${input(p.description.value, `data-path="parameters.${i}.description.value"`, { placeholder: '설명' })} |
${p.type.locked
? lockedInput(p.type.value)
: selectInput(p.type.value, ['string', 'integer', 'number', 'boolean'], `data-path="parameters.${i}.type.value"`)} |
+ ${input(p.maxLength.value, `data-path="parameters.${i}.maxLength.value"`, { placeholder: '0', extra: 'text-xs' })} |
${checkbox(p.required.value, `data-path="parameters.${i}.required.value" data-type="bool"`, { locked: p.required.locked })} |
- ${selectInput(p.format.value, ['', 'uuid', 'date', 'date-time', 'email', 'uri'], `data-path="parameters.${i}.format.value"`)} |
- ${input(p.maxLength.value, `data-path="parameters.${i}.maxLength.value"`, { placeholder: 'maxLength', extra: 'text-xs' })} |
- ${input(p.description.value, `data-path="parameters.${i}.description.value"`, { placeholder: '설명' })} |
- ${input(p.example.value, `data-path="parameters.${i}.example.value"`, { placeholder: '예제' })} |
+ ${input(p.example.value, `data-path="parameters.${i}.example.value"`, { placeholder: '예제값' })} |
- ${p.name.locked ? '🔒' : ``}
+ ${p.name.locked ? '' : ``}
|
-
- `).join('');
+ `;
+ }).join('');
return card(
- sectionTitle('파라미터 (Header / Query / Path / Cookie)', '게이트웨이가 등록한 파라미터는 잠금됩니다. 추가 파라미터는 자유롭게 정의하세요.') +
+ sectionTitle(isHeader ? '요청 Header' : 'Parameter (Query)', '게이트웨이가 등록한 항목은 잠금됩니다. 추가 항목은 자유롭게 정의하세요.') +
`
- | 위치 |
이름 |
- 타입 |
- 필수 |
- format |
- maxLen |
설명 |
- 예제 |
+ 타입 |
+ 길이 |
+ 필수 |
+ 예제값 |
|
- ${rows}
+ ${rows || `| 등록된 항목이 없습니다 |
`}
-
+
`
);
}
@@ -494,10 +581,12 @@
function renderBodyTable() {
return card(
sectionTitle('Request Body 스키마', `media type: ${state.data.requestBody.mediaType}. 중첩된 object/array 를 모두 지원합니다.`) +
- `
-
- ${checkbox(state.data.requestBody.required.value, 'data-path="requestBody.required.value" data-type="bool"', { locked: state.data.requestBody.required.locked })}
-
🔒
+ `
+
기본 동작과 잠금
+
+ - 여기서 설정하는 validation(타입·필수·제약 등)은 실제 게이트웨이(GW) 동작에는 영향을 주지 않습니다. 개발자 포털과 OpenAPI Spec 문서에만 반영되는 참고 정보입니다.
+ - 🔒 표시된 필드는 GW 레이아웃에 등록된 필드로, 삭제하거나 속성(이름·타입·필수 등)을 변경할 수 없습니다. 추가 필드는 자유롭게 정의·삭제할 수 있습니다.
+
` +
renderSchemaTable(state.data.requestBody.schema, 'requestBody.schema') +
`
@@ -514,12 +603,14 @@
const tabsHtml = codes.map(code => `
`).join('');
return card(
- sectionTitle('Response 스키마', '상태 코드별로 응답 스키마를 정의합니다.') +
- `
${tabsHtml}
` +
+ sectionTitle('Response 스키마', '상태 코드별로 응답 스키마를 정의합니다. 추가한 상태코드는 [요청/응답 샘플]의 응답 예제와 연동됩니다.') +
+ `
${tabsHtml}
+
+
` +
`
${fieldRow('설명', input(r.description.value, `data-path="responses.${cur}.description.value"`, { placeholder: '응답 설명' }))}
` +
renderSchemaTable(r.schema, `responses.${cur}.schema`) +
`
@@ -543,38 +634,38 @@
- | 필드명 |
- 타입 |
- 필수 |
- format |
- maxLen |
- 제약 |
+ # |
+ 잠금 |
+ 필드명 |
설명 |
- 예제 |
+ 타입 |
+ 길이 |
+ 필수 |
+ 예제값 |
|
- ${renderSchemaRows(rows, basePath, 0)}
+ ${renderSchemaRows(rows, basePath, 0, '')}
`;
}
- function renderSchemaRows(rows, basePath, depth) {
+ function renderSchemaRows(rows, basePath, depth, seqPrefix) {
let html = '';
rows.forEach((row, idx) => {
const path = `${basePath}.${idx}`;
+ const seq = seqPrefix ? `${seqPrefix}-${idx + 1}` : String(idx + 1); // 계층 시퀀스 (1, 1-1, 2-1-1 …)
const isLocked = row.name.locked;
const isObject = row.type.value === 'object';
const isArray = row.type.value === 'array';
- const hasChildren = isObject && row.children && row.children.length;
const expandedKey = `${path}.__expanded`;
const isExpanded = state[expandedKey] !== false;
- const constraintsKey = `${path}.__constraints`;
- const showConstraints = !!state[constraintsKey];
html += `
+ | ${seq} |
+ ${isLocked ? '🔒' : ''} |
${isObject || isArray
@@ -582,40 +673,27 @@
: ` `}
${isObject ? '{}' : isArray ? '[]' : '·'}
${isLocked
- ? `
-
- 🔒
- `
+ ? ` `
: input(row.name.value, `data-path="${path}.name.value"`, { extra: 'flex-1' })}
|
+ ${input(row.description.value, `data-path="${path}.description.value"`, { placeholder: '설명' })} |
${row.type.locked
- ? lockedInput(row.type.value)
+ ? ``
: selectInput(row.type.value,
['string', 'integer', 'number', 'boolean', 'array', 'object'],
`data-path="${path}.type.value" data-rerender="step3"`)}
|
-
- ${checkbox(!!row.required.value, `data-path="${path}.required.value" data-type="bool"`, { locked: row.required.locked })}
- |
-
- ${isObject || isArray
- ? '—'
- : selectInput(row.format.value, ['', 'uuid', 'date', 'date-time', 'email', 'uri', 'int32', 'int64', 'float', 'double', 'byte', 'binary'], `data-path="${path}.format.value"`)}
- |
${row.type.value === 'string'
? input(row.maxLength.value, `data-path="${path}.maxLength.value"`, { placeholder: '0', extra: 'text-xs' })
: '—'}
|
-
+ ${checkbox(!!row.required.value, `data-path="${path}.required.value" data-type="bool"`, { locked: row.required.locked })}
|
- ${input(row.description.value, `data-path="${path}.description.value"`, { placeholder: '설명' })} |
${isObject ? '— (자식 참조)' :
isArray
@@ -623,52 +701,20 @@
items:
${selectInput((row.itemsType && row.itemsType.value) || 'string', ['string', 'integer', 'number', 'boolean'], `data-path="${path}.itemsType.value"`, { extra: 'text-xs' })}
`
- : input(row.example.value, `data-path="${path}.example.value"`, { placeholder: '예제' })}
+ : input(row.example.value, `data-path="${path}.example.value"`, { placeholder: '예제값' })}
|
${isLocked
- ? '🔒'
+ ? ''
: ``}
|
`;
- // 제약 expand 행
- if (showConstraints) {
- html += `
-
-
-
-
-
- ${input(row.pattern.value, `data-path="${path}.pattern.value"`, { placeholder: '^[A-Z]+$', extra: 'text-xs' })}
-
-
-
- ${input((row.enumStr && row.enumStr.value) || '', `data-path="${path}.enumStr.value"`, { placeholder: 'A,B,C', extra: 'text-xs' })}
-
-
-
- ${input((row.minimum && row.minimum.value) || '', `data-path="${path}.minimum.value"`, { placeholder: '0', extra: 'text-xs' })}
-
-
-
- ${input((row.maximum && row.maximum.value) || '', `data-path="${path}.maximum.value"`, { placeholder: '100', extra: 'text-xs' })}
-
-
-
- ${input((row.default && row.default.value) || '', `data-path="${path}.default.value"`, { placeholder: '기본값', extra: 'text-xs' })}
-
- |
-
- `;
- }
-
// children
if (isObject && isExpanded) {
if (row.children && row.children.length) {
- html += renderSchemaRows(row.children, `${path}.children`, depth + 1);
+ html += renderSchemaRows(row.children, `${path}.children`, depth + 1, seq);
}
html += `
@@ -683,11 +729,11 @@
}
// ============================================================
- // 9. Step 4 — 인증 / 보안
+ // 9. 인증 / 보안 (기본정보 Step 에 병합된 섹션)
// ============================================================
- function renderStep4(root) {
+ function renderAuthSection() {
var schemes = state.data.securitySchemes || [];
- root.innerHTML = card(
+ return card(
sectionTitle('인증 / 보안', '게이트웨이(GW)에 설정된 인증만 표시됩니다. (읽기 전용)') +
(schemes.length
? schemes.map((s, i) => renderSecuritySchemeCard(s, i)).join('')
@@ -737,61 +783,164 @@
}
// ============================================================
- // 10. Step 5 — 예제 / 응답
+ // 10. Step 4 — 요청/응답 샘플 (하위 탭: 요청=편집, 응답=읽기전용(응답 정보에서 파생))
// ============================================================
- function renderStep5(root) {
- const reqObj = state.data.examples.request['application/json'] || { default: '' };
- const req = reqObj.default || '';
- const codes = Object.keys(state.data.examples.response);
- const cur = state.responseStatusTab;
- const curSet = state.data.examples.response[cur] || { body: '', headers: [] };
- const taCls = 'w-full px-3 py-2 text-xs font-mono rounded border border-slate-300 focus:outline-none focus:ring-2 focus:ring-brand-500';
+ // 응답 예제 본문을 응답 정보(스키마·예제값)에서 파생해 동기화 — 응답 샘플은 항상 응답 정보 세팅을 따른다.
+ function syncResponseExamplesFromSchema() {
+ var d = state.data;
+ Object.keys(d.responses || {}).forEach(function (code) {
+ var set = d.examples.response[code] || (d.examples.response[code] = { body: '', headers: [] });
+ set.body = JSON.stringify(_sampleObj((d.responses[code] || {}).schema || []), null, 2);
+ });
+ }
- root.innerHTML = `
- ${card(
+ function renderStep5(root) {
+ const tab = state.sampleTab || 'request';
+ const tabs = [{ key: 'request', label: '요청' }, { key: 'response', label: '응답' }];
+ const taCls = 'w-full px-3 py-2 text-xs font-mono rounded border border-slate-300 focus:outline-none focus:ring-2 focus:ring-brand-500';
+ let body;
+ if (tab === 'request') {
+ const _mt = (state.data.requestBody && state.data.requestBody.mediaType) || 'application/json';
+ const req = (state.data.examples.request[_mt] || { default: '' }).default || '';
+ body = card(
sectionTitle('요청 본문 예제 (application/json)') +
- `` +
+ `` +
`` +
`스키마와 자동 매핑되어 Swagger UI 의 예제 영역에 노출됩니다.
`
- )}
-
- ${card(
- sectionTitle('응답 예제', '상태코드별 본문/헤더 1세트. 기본 200 + 추가 등록 가능.') +
+ );
+ } else {
+ syncResponseExamplesFromSchema(); // 응답 정보 세팅 → 예제 파생(읽기 전용)
+ const codes = Object.keys(state.data.examples.response);
+ const cur = state.responseStatusTab;
+ const curSet = state.data.examples.response[cur] || { body: '', headers: [] };
+ body = card(
+ sectionTitle('응답 예제 (읽기 전용)', '응답 정보(스키마·예제값)에서 자동 생성됩니다. 수정은 [응답 정보] 탭에서 하세요.') +
`
${codes.map(code => `
+ ${cur === code ? 'border-brand-600 text-brand-700 font-medium' : 'border-transparent text-slate-600'}">${escapeHtml(code)}
`).join('')}
-
` +
- `` +
- `` +
- `
-
-
-
- | name | type | description | example | |
|---|
-
-
- ${(curSet.headers || []).map((h, i) => `
-
- | ${input(h.name, `data-resp-header="${i}.name"`)} |
- ${selectInput(h.type, ['string', 'integer', 'number', 'boolean'], `data-resp-header="${i}.type"`)} |
- ${input(h.description, `data-resp-header="${i}.description"`)} |
- ${input(h.example, `data-resp-header="${i}.example"`)} |
- |
-
- `).join('')}
-
-
-
-
-
-
응답 헤더는 [응답 정보 > Header] 에서 관리합니다.
`
+ );
+ }
+ root.innerHTML = subTabBar(tabs, tab, 'data-sample-tab') + body;
+ initExampleEditors(tab); // 요청=편집 CodeMirror, 응답=읽기전용 CodeMirror
+ }
+
+ // (구 요청/응답(웹페이지) 스텝은 요청/응답 정보의 'API 설명(HTML)' 서브 탭으로 흡수됨)
+
+ // 스키마 → 설명 자료 HTML 표(필드명/타입/필수/길이/설명). 현재 편집 중 스키마(추가 필드 포함) 기준.
+ function schemaToSpecHtml(rows) {
+ var out = ''
+ + '| 필드명 | '
+ + '타입 | '
+ + '필수 | '
+ + '길이 | '
+ + '설명 |
';
+ function walk(list, depth) {
+ (list || []).forEach(function (r) {
+ if (!r || !r.name) return;
+ var pad = new Array(depth + 1).join(' ');
+ var req = 'Y'; // 설명 자료 HTML: 필수 여부 기본값 = 필수(Y)
+ var len = (r.maxLength && r.maxLength.value) || '';
+ // 필드명·설명 = 좌측 정렬, 나머지(타입·필수·길이) = 가운데 정렬
+ out += ''
+ + '| ' + pad + escapeHtml(r.name.value || '') + ' | '
+ + '' + escapeHtml(r.type.value || '') + ' | '
+ + '' + req + ' | '
+ + '' + escapeHtml(String(len)) + ' | '
+ + '' + escapeHtml((r.description && r.description.value) || '') + ' |
';
+ if (r.children && r.children.length) walk(r.children, depth + 1);
+ });
+ }
+ walk(rows, 0);
+ out += '
';
+ return out;
+ }
+ function regenReqSpec() {
+ var d = state.data;
+ d.msgSpec.request = schemaToSpecHtml(d.requestBody ? d.requestBody.schema : []);
+ renderForm();
+ toast('요청 설명 자료를 스키마 기준으로 재생성했습니다');
+ }
+ function regenResSpec() {
+ var d = state.data;
+ var r = (d.responses && (d.responses['200'] || d.responses[Object.keys(d.responses)[0]])) || {};
+ d.msgSpec.response = schemaToSpecHtml(r.schema || []);
+ renderForm();
+ toast('응답 설명 자료를 스키마 기준으로 재생성했습니다');
+ }
+
+ // 개발자포탈과 동일한 Summernote 툴바 + 편집영역(.editor-content) 스타일
+ var DJB_SN_TOOLBAR = [
+ ['style', ['style']],
+ ['font', ['bold', 'underline', 'clear']],
+ ['color', ['color']],
+ ['para', ['ul', 'ol', 'paragraph']],
+ ['table', ['table']],
+ ['insert', ['link', 'picture']],
+ ['view', ['fullscreen', 'codeview', 'help']]
+ ];
+ function addEditorContentClass() { if (window.jQuery) window.jQuery('.note-editable').addClass('editor-content'); }
+
+ // 설명 자료 = Summernote 리치 에디터. state.data.msgSpec[key] 에 HTML 저장.
+ function initSpecEditor(sel, key, height) {
+ if (!(window.jQuery && window.jQuery.fn && window.jQuery.fn.summernote)) return;
+ var $e = window.jQuery(sel);
+ if (!$e.length) return;
+ try { $e.summernote('destroy'); } catch (e) {}
+ var koOk = window.jQuery.summernote && window.jQuery.summernote.lang && window.jQuery.summernote.lang['ko-KR'];
+ $e.summernote({
+ height: height || 300,
+ lang: koOk ? 'ko-KR' : 'en-US',
+ placeholder: '여기에 내용을 입력하세요.',
+ toolbar: DJB_SN_TOOLBAR,
+ callbacks: {
+ onInit: addEditorContentClass,
+ onChange: function (contents) { state.data.msgSpec[key] = contents; }
+ }
+ });
+ $e.summernote('code', state.data.msgSpec[key] || '');
+ addEditorContentClass();
+ }
+
+ // 요청/응답 본문 예제 textarea 를 CodeMirror(JSON) 에디터로 승격. renderStep5 마다 재생성(폼 재렌더 시 wipe→재초기화).
+ // 요청 = 편집 가능, 응답 = 읽기 전용(응답 정보에서 파생).
+ function initExampleEditors() {
+ if (!window.CodeMirror) return;
+ var cmOpt = { mode: { name: 'javascript', json: true }, lineNumbers: true, lineWrapping: true, viewportMargin: Infinity, tabSize: 2 };
+ var reqTa = $('[data-example-target="request"]');
+ if (reqTa) {
+ var cmReq = CodeMirror.fromTextArea(reqTa, cmOpt);
+ cmReq.setSize('100%', 300);
+ cmReq.on('change', function (c) {
+ var mt = (state.data.requestBody && state.data.requestBody.mediaType) || 'application/json';
+ state.data.examples.request[mt] = state.data.examples.request[mt] || { default: '' };
+ state.data.examples.request[mt].default = c.getValue();
+ schedulePreviewSync();
+ });
+ }
+ var resTa = $('[data-example-target="response"]');
+ if (resTa) {
+ var cmRes = CodeMirror.fromTextArea(resTa, Object.assign({}, cmOpt, { readOnly: true }));
+ cmRes.setSize('100%', 300);
+ }
+ }
+
+ // 응답유형별 실제 호출 주소. 경로(op.path.value)에 어댑터경로가 이미 포함, 호스트만 응답유형별로 앞에 붙임.
+ function resolvedCallUrl() {
+ var d = state.data;
+ var rt = (d.portal && d.portal.responseType) || 'sample';
+ var host;
+ if (rt === 'gw') host = (window.DJB_CTX && window.DJB_CTX.gwAddress) || 'http://127.0.0.1:39310';
+ else if (rt === 'mock') host = (d.portal && d.portal.mockUrl) || '';
+ else host = '';
+ var path = (d.operation && d.operation.path && d.operation.path.value) || '';
+ if (!host) return path || '(주소 없음)';
+ return host.replace(/\/+$/, '') + (path.charAt(0) === '/' ? path : '/' + path);
}
// ============================================================
@@ -805,9 +954,20 @@
const orgChips = (p.orgs || []).map((o, i) =>
`${escapeHtml(o.orgName || o.id)}✕`
).join('');
+ const groupChips = (p.apiGroups || []).map((g, i) =>
+ `${escapeHtml(g.groupName || g.id)}✕`
+ ).join('');
root.innerHTML =
card(
sectionTitle('포탈 게시 정보', '개발자포탈 공개 설정. 기존 API 스펙 화면의 값을 불러와 적용합니다.') +
+ fieldRow('API 그룹',
+ `
+
+ ${groupChips || '선택된 그룹 없음'}
+
+
+
API 그룹은 apiGroupMan(API 그룹 관리)에서도 관리됩니다.
+
@@ -819,15 +979,26 @@
전부 선택 시 로그인 사용자 전체에게 공개됩니다.
-
${orgChips || '선택된 법인 없음'}
-
+ `
+
+ ${orgChips || '선택된 법인 없음'}
+
+
+
특정 법인에게만 공개하고 싶을 때 공개 법인을 선택하시면 됩니다.
`) : '') +
fieldRow('응답 유형',
+ '
' +
['sample', 'mock', 'gw'].map(v =>
`
`
- ).join('')) +
- (rt === 'mock' ? fieldRow('Mock URL', input(p.mockUrl || '', 'data-portal="mockUrl"', { placeholder: 'https://...' })) : '')
+ ).join('') +
+ `
실제 호출 주소: ${escapeHtml(resolvedCallUrl())}
` +
+ (rt === 'gw' ? `
GW 주소는 포탈 설정(PTL_PROPERTY, 그룹 Portal)의 djb.gateway.base-url 값을 사용합니다.
` : '') +
+ '
') +
+ (rt === 'mock' ? fieldRow('Mock Server URL', input(p.mockUrl || '', 'data-portal="mockUrl"', { placeholder: 'https://mock.example.com' }), { hint: 'Mock 응답을 제공할 서버의 기본 URL. 응답 유형이 Mock 일 때 개발자포탈이 이 주소로 요청을 전달하고, Swagger 스펙의 서버 주소로도 사용됩니다.' }) : '')
+ ) +
+ card(
+ sectionTitle('설명 (API 소개 페이지)', 'API 소개 페이지에만 표시됩니다. OpenAPI 스펙 파일에는 포함되지 않습니다.') +
+ '
' + (state.data.info.description.value || '') + '
'
) +
card(
sectionTitle('내보내기', 'OpenAPI 스펙을 파일로 저장합니다.') +
@@ -836,6 +1007,7 @@
'
+ + '
' + escapeHtml(title) + '
'
+ + '