사용자 정의 정적 템플릿 관리
템플릿 파일 등록을 관리하세요.
시작하기 전에
템플릿 파일 등록 관리
템플릿 파일 등록
curl -X POST 'https://<tenant>/template/v1.0/branding/registration/<type>' --header 'Authorization: Bearer <access_token>' -F 'file=@"<file>"'
이 명령은 템플릿 파일을 등록합니다. 아래 표에는 허용되는 파일 형식이 나와 있습니다.
| 허용되는 유형 | 허용되는 파일 확장자 | 유형별 최대 파일 수 | 파일당 최대 크기 |
|---|---|---|---|
| js | .js | 15 | 300KB |
| CSS | .css | 15 | 100KB |
| 아이콘 | .ico,.png 및.svg | 30 | 100KB |
| 이미지 | .png,.jpg,.jpeg,.gif,.svg 및.webp | 15 | 500KB |
| 글꼴 | .woff, .woff2,.ttf,.otf 및.eot | 15 | 500KB |
특정 유형의 모든 템플릿 파일 가져오기
curl -X GET 'https://<tenant>/template/v1.0/branding/registration/<type>' -H 'Authorization: Bearer <access_token>'
이 명령은 특정 파일 유형으로 등록된 모든 파일을 나열합니다.
템플릿 파일 삭제
curl -X DELETE 'https://<tenant>/template/v1.0/branding/registration/<type>/<file_name>' --header 'Authorization: Bearer <access_token>'
이 명령은 기존 파일을 삭제합니다.
특정 유형의 모든 템플릿 파일 삭제
curl -X DELETE 'https://<tenant>/template/v1.0/branding/registration/<type>' --header 'Authorization: Bearer <access_token>'
이 명령어는 지정된 파일 유형으로 등록된 모든 파일을 삭제합니다.
템플릿 파일 사용자 지정
템플릿 파일은 등록한 후에도 업데이트할 수 있습니다. 기존 템플릿 파일을 수정하려면 다음 페이지를 참조하십시오:
참고: 웹 페이지를 업데이트한 후 API 경로를
/template/v1.0/static 통해 해당 파일을 참조하는 경우, 변경 사항이 즉시 반영되지 않을 수 있습니다. 브라우저 캐시를 지우고, 업데이트가 적용될 때까지 최대 5분 정도 기다려 주세요.HTML에서 등록된 파일 사용하기
파일을 .js 생성하고, 해당 <js-filename> 파일을 등록한 다음 HTML 페이지에 추가하세요:
<script type="text/javascript" src="/template/v1.0/static/js/<js-filename>?themeId=@THEME_ID@"></script>
이미지 파일 의 경우, 파일을 <image-filename> 등록한 다음 HTML 페이지에 삽입하세요:
<img src="/template/v1.0/static/assets/image/<image-filename>?themeId=@THEME_ID@">
아이콘 파일 의 경우, 파일을 <icon-filename> 등록하고 HTML 페이지에 추가하세요:
<link rel="icon" href="/template/v1.0/static/assets/icon/<icon-filename>?themeId=@THEME_ID@">
파일을 .css 생성하고, 해당 <css-filename> 파일을 등록한 다음 HTML 페이지에 추가하세요:
<link rel="stylesheet" href="/template/v1.0/static/assets/css/<css-filename>?themeId=@THEME_ID@">
<css-filename>글꼴 파일 의 경우, 해당 파일을 파일에 .css 포함시키세요:
@font-face {
font-family: '<font-family>';
src: url('/template/v1.0/static/assets/fonts/<font-filename>?themeId=@THEME_ID@') format('<font-format>')
}
.custom-text {
font-family: '<font-family>'
}
<css-filename>글꼴 <font-filename> 파일과 파일을 .css 등록한 후, HTML 페이지에 추가하세요:
<link rel="stylesheet" href="/template/v1.0/static/assets/css/<css-filename>?themeId=@THEME_ID@" />
참고: @THEME_ID@는 테마 ID를 나타내는 매크로입니다. 실행 시점에 실제 themeId 로 대체됩니다.