---
updatedAt: 2025-07-21T10:03:05.000Z
agentTools:
  projectIndex: https://developers.modusign.co.kr/llms.txt
---

# 임베디드 템플릿 수정

임베디드 템플릿 수정은 고객사의 사이트에서 템플릿을 수정할 수 있는 기능입니다.

 

# **1. 임베디드 템플릿 수정 URL 요청**

### GET 임베디드 템플릿보기 url 조회 API

#### 요청하기

```curl
curl --request GET \
  --url https://api.modusign.co.kr/templates/TEMPLATE_ID/embedded-view \
  --header 'Accept: application/json' \
  --header 'Authorization: Basic {인코딩된 API-KEY}' \
  --header 'Content-Type: application/json'
```

#### 응답 body

```json
{
  "id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "expiry": "2021-01-01T00:00:00.000Z",
  "embeddedUrl": "https://app.modusign.co.kr/embedded-template/XXX?at=XXXXXXX..."
}
```

이 API 요청의 응답 예시는 위와 같습니다.\
응답의 `embeddedUrl` 에는 접속 가능한 URL이 전달됩니다. 해당 URL은 **2시간 동안만** 유효합니다.

> ❗️ HTTP API를 클라이언트에서 호출하지 마세요!
>
> API 호출에 사용되는 **API KEY**는 유저의 권한을 획득하는 민감한 데이터입니다.\
> 클라이언트에 KEY를 노출해서는 안 되며, 서버 사이드에서 보호되어야 합니다.

 

 

# **2. 임베디드 URL 열기**

해당 URL을 클라이언트로 전달하여, **새 창, 새 탭 또는 iframe 내**에서 열 수 있습니다.\
열린 페이지를 통해 템플릿을 수정할 수 있습니다.

#### 클라이언트 사이드

```javascript
// 새탭으로 열기
window.open("https://app.modusign.co.kr/embedded-template/XXX?at=XXXXXXX...");

// 새창으로 열기
window.open(
  'https://app.modusign.co.kr/embedded-template/XXX?at=XXXXXXX...',
  '_blank', 
  'top=10, left=10, width=1440, height=900'
);

// iframe에 열기
var targetIframe = document.getElementById('target-iframe');
targetIframe.src = 'https://app.modusign.co.kr/embedded-template/XXX?at=XXXXXXX...';
```