사용자 정의 정적 템플릿 관리

템플릿 파일 등록을 관리하세요.

시작하기 전에

템플릿 파일 등록 관리

템플릿 파일 등록

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 로 대체됩니다.