전자계약 API, 뭐부터 시작해야 할까요? 서식 만들기부터 토큰 발급까지

전자계약 API, 뭐부터 시작해야 할까요? 서식 만들기부터 토큰 발급까지

전자계약 API를 처음 시작한다면 코드를 작성하기 전에 먼저 이싸인온에서 사용할 서식을 만들고, 그다음 API 호출에 필요한 인증 토큰을 발급해보는 것부터 시작하면 됩니다.

서식은 API로 어떤 문서를 보낼지 정하는 기본 틀이 되고, 인증 토큰은 이싸인온 API를 호출하기 위해 필요한 인증 정보입니다.

처음부터 ERP나 사내 시스템 전체를 연결할 필요는 없습니다.

① 서식 만들기 → ② 토큰 발급 → ③ 테스트 문서 한 건 보내보기

이 정도만 진행해도 API 연동의 기본 구조를 훨씬 쉽게 이해할 수 있습니다.

이번 글에서는 신규 입사자의 근로계약서를 자동으로 보내고 싶은 회사를 예로 들어 이싸인온 API를 처음 시작하는 과정을 살펴보겠습니다.

🤔 근로계약서를 API로 보내고 싶은데, 뭐부터 해야 할까요?

A회사는 신규 입사자가 생길 때마다 인사 담당자가 근로계약서를 작성하고 있습니다.

직원 정보는 이미 HR 시스템에 있지만 계약서를 보낼 때는 담당자가 다시 직원 이름, 입사일, 부서 등의 정보를 입력해야 합니다.

그래서 다음과 같은 업무를 만들고 싶습니다.

HR 시스템에 신규 입사자 등록→ 직원 정보로 근로계약서 생성→ 전자계약 발송→ 직원 서명→ 계약 완료 확인

장기적으로는 이 과정을 API로 연결하고 싶지만, 담당자는 API를 처음 사용합니다.

이럴 때 가장 먼저 해야 하는 것은 복잡한 코드를 작성하는 것이 아닙니다.

먼저 실제로 보낼 계약서부터 준비하는 것입니다.

1. 📄 가장 먼저, 이싸인온 서식을 만들어보세요

이싸인온 API에서는 미리 만들어둔 서식을 기반으로 문서를 시작할 수 있습니다.

따라서 API를 테스트하기 전에 먼저 **“어떤 문서를 API로 보낼 것인가?”**를 정해야 합니다.

A회사라면 신규 입사자에게 보낼 근로계약서 서식을 먼저 준비합니다.

기존에 사용하던 계약서 파일을 이싸인온에 등록한 뒤 필요한 작성란을 설정할 수 있습니다.

예를 들어 다음과 같은 항목입니다.

여기서 중요한 것은 누가 입력할 정보인지 구분하는 것입니다.

회사 시스템에 이미 있는 이름, 부서, 입사일과 같은 정보는 API를 통해 미리 입력할 수 있고, 직원이 직접 확인하거나 작성해야 하는 항목은 전자계약 과정에서 입력하도록 구성할 수 있습니다.

즉, API 연동을 시작하기 전에 계약서 안의 데이터를 먼저 회사에서 입력할 정보 / 서명자가 입력할 정보로 나눠보는 것이 좋습니다.

💡 왜 토큰보다 서식을 먼저 만들어야 할까요?

인증 토큰만 발급받는다고 바로 계약서를 보낼 수 있는 것은 아닙니다.

API를 통해 문서를 시작하려면 어떤 서식을 사용할지, 그리고 해당 서식 안의 어떤 작성란에 어떤 값을 넣을지를 알아야 합니다.

예를 들어 근로계약서를 API로 발송하려면,

▪️사용할 근로계약서 서식

▪️직원 이름이 들어갈 필드

▪️입사일이 들어갈 필드

▪️부서가 들어갈 필드

▪️계약 상대방 정보 등을 먼저 정해야 합니다.

그래서 API 연동을 처음 시작한다면 코드부터 작성하기보다 실제로 사용할 문서를 이싸인온에서 한번 만들어보는 것이 이해하기 쉽습니다.

2. 🔑 서식을 만들었다면 인증 토큰을 발급해보세요

서식이 준비됐다면 다음은 인증 토큰 발급입니다.

인증 토큰은 이싸인온 API를 사용할 때 “이 요청을 보낸 사용자가 누구인지” 확인하기 위한 인증 정보입니다.

이싸인온 API를 호출할 때는 대부분의 요청에 인증 토큰이 필요하기 때문에 실제 API 테스트를 시작하기 위한 기본 준비 단계라고 볼 수 있습니다.

토큰 발급을 위해서는 이싸인온의 회사 정보와 사용자 계정 정보를 확인하게 됩니다.

처음 API를 테스트하는 단계에서는 어려운 기능부터 구현하기보다 먼저 **“인증 토큰이 정상적으로 발급되는가?”**를 확인하는 것부터 시작하면 됩니다.

🔐 인증 토큰을 사용할 때는 이것도 주의하세요

최근에는 ChatGPT, Claude와 같은 AI 코딩 도구를 활용해 API 연동을 직접 테스트하는 경우도 많습니다.

AI에게 API 문서를 설명하거나 예제 코드를 작성하도록 요청하는 것은 도움이 될 수 있지만, 실제 인증 정보는 주의해서 관리해야 합니다.

▪️실제 인증 토큰

▪️사용자 비밀번호

▪️고객 개인정보

▪️실제 계약 데이터와 같은 정보는 AI 서비스에 그대로 입력하지 않는 것이 좋습니다.

AI는 코드 작성이나 오류 확인을 도와주는 도구로 활용하고, 실제 인증 정보는 별도로 안전하게 관리해야 합니다.

3. 🚀 이제 테스트 계약서 한 건을 보내보세요

서식도 만들었고 토큰도 정상적으로 발급됐다면 이제 실제 API 호출을 테스트할 수 있습니다.

처음부터 직원 수십 명의 계약서를 보내려고 할 필요는 없습니다. 테스트용 계약서 한 건이면 충분합니다.

A회사의 경우 다음과 같이 시작할 수 있습니다.

STEP 1

근로계약서 서식을 준비합니다.

STEP 2

인증 토큰을 발급합니다.

STEP 3

테스트 직원 정보를 준비합니다.
이름, 이메일 또는 휴대전화번호, 부서, 입사일 등

STEP 4

준비한 근로계약서 서식을 이용해 문서 발송 API를 테스트합니다.

STEP 5

직원에게 정상적으로 서명 요청이 도착했는지 확인합니다.

STEP 6

서명이 완료된 뒤 문서 상태도 확인해봅니다.
여기까지 성공했다면 이미 서식 → 인증 → 데이터 입력 → 문서 발송 → 전자서명 → 완료라는 전자계약 API의 가장 기본적인 흐름을 한 번 경험한 것입니다.

👀 첫 테스트에서 무엇을 확인하면 될까요?

처음 테스트할 때는 기능을 많이 사용하는 것보다 한 건이 처음부터 끝까지 정상적으로 진행되는지 확인하는 것이 중요합니다.

다음 정도만 체크해보세요.

▪️사용할 서식이 정상적으로 조회되는가?

▪️인증 토큰이 정상적으로 발급되는가?

▪️수신인 정보가 제대로 전달되는가?

▪️회사에서 입력한 데이터가 계약서의 올바른 위치에 들어가는가?

▪️상대방에게 서명 요청이 정상적으로 전달되는가?

▪️서명 완료 후 문서 상태를 확인할 수 있는가?

이 과정에서 문제가 발생하면 어느 단계에서 문제가 생겼는지도 비교적 쉽게 찾을 수 있습니다.

처음부터 여러 기능을 한꺼번에 연결하는 것보다 하나의 계약 흐름을 완성한 뒤 다음 기능을 붙이는 방식이 훨씬 이해하기 쉽습니다.

⚙️ 한 건 발송에 성공했다면 그다음은 무엇을 해볼까요?

첫 번째 계약서 발송에 성공했다면 이제 필요한 기능을 하나씩 확장할 수 있습니다.

데이터를 자동으로 넣고 싶다면

HR 시스템이나 ERP에 있는 이름, 부서, 계약 조건 등의 데이터를 서식의 작성란과 연결할 수 있습니다.

계약 진행 상태를 확인하고 싶다면

문서 상태 조회 API를 활용해 계약이 진행 중인지, 완료되었는지 확인할 수 있습니다.

계약이 끝났을 때 자동으로 다음 업무를 진행하고 싶다면

Webhook 등을 활용해 문서 상태 변경 정보를 기존 시스템으로 전달받는 방식도 검토할 수 있습니다.

즉, 서식 만들기→ 토큰 발급→ 문서 한 건 발송→ 상태 확인→ 내부 시스템 데이터 연동→ 완료 후 업무 연결 순서로 조금씩 범위를 넓혀가는 것입니다.

처음부터 모든 기능을 구현할 필요는 없습니다.

🤖 AI로 API를 만들고 있다면 더 작게 나눠서 시작해보세요

AI 코딩 도구를 활용해 API를 처음 연동한다면 한 번에 “우리 ERP와 전자계약 전체를 연동해줘.” 라고 요청하기보다 필요한 기능을 단계별로 나누는 것이 좋습니다.

“인증 토큰을 발급하는 요청부터 만들어줘.”

“이 서식 ID로 테스트 문서 한 건을 보내고 싶어.”

“발송한 문서의 상태를 조회하고 싶어.” 처럼 기능을 하나씩 테스트하는 방식입니다.

최근에는 API 개발 경험이 많지 않은 담당자도 AI의 도움을 받아 직접 기본적인 테스트를 진행하는 경우가 늘고 있습니다.

다만 AI가 만들어준 코드가 항상 실제 운영 환경에 적합한 것은 아니므로, 테스트 결과와 보안 설정을 충분히 확인한 뒤 실제 시스템에 적용하는 것이 좋습니다.

🙋 자주 묻는 질문

Q. API를 시작하려면 개발부터 해야 하나요?

아닙니다. 실제 개발에 들어가기 전에도 먼저 사용할 계약서 서식을 만들고 어떤 데이터를 연동할 것인지 정리할 수 있습니다.

서식 구조와 업무 흐름이 정리되어 있으면 이후 개발 범위도 훨씬 명확해집니다.

Q. 서식 없이 토큰부터 발급해도 되나요?

토큰 발급 자체는 별개의 인증 과정이지만, 실제 문서 발송 테스트까지 이어가기 위해서는 사용할 서식이 필요합니다.

처음 API를 이해하는 단계라면 서식 준비 → 토큰 발급 → 문서 발송 순서로 진행하면 흐름을 이해하기 쉽습니다.

Q. 처음에는 어떤 계약서로 테스트하는 것이 좋나요?

실제 회사에서 자주 사용하는 문서 중 구조가 단순한 문서 한 종류를 선택하는 것이 좋습니다.

근로계약서, 동의서, 정산 합의서 등 실제 API 연동을 검토하고 있는 업무와 비슷한 문서를 활용하면 이후 운영 환경으로 확장하기도 쉽습니다.

Q. 문서 한 건을 보내고 나면 무엇을 테스트해야 하나요?

문서 상태 조회부터 확인해보는 것을 추천합니다.

이후 필요에 따라 내부 데이터 자동 입력, Webhook, 완료 문서 활용 등으로 범위를 확장할 수 있습니다.

🎁 지금은 실제 이싸인온 계정에서 API를 30일간 체험할 수 있습니다

API 문서를 보는 것만으로는 우리 회사에서 실제로 연동할 수 있을지 판단하기 어렵습니다.

그래서 이싸인온에서는 2026년 9월 API 체험 프로모션을 진행하고 있습니다.

API 도입을 검토하고 있다면 별도의 API 요금제를 먼저 구매하지 않고도 실제 이싸인온 계정에서 API 기능을 30일간 직접 테스트해볼 수 있습니다.

📢 2026년 9월 API 체험 프로모션

▪️신청 기간 : 2026년 9월 1일 ~ 9월 30일

▪️대상 : 신규 고객 및 Business 요금제 이용 고객

▪️혜택 : 별도 API 요금제 구매 없이 API 기능 30일 체험

▪️체험 기간 : API 권한 활성화일로부터 30일

▪️이용 방식 : 실제 계정과 실제 서식을 이용해 API 테스트

▪️신청 방법 : 이싸인온 고객센터를 통해 신청

※ 신규 고객은 회원가입 시 제공되는 무료체험 건수 범위에서 API를 사용할 수 있으며, 기존 Business 고객은 현재 보유한 이용 건수에서 발송 건수가 차감됩니다. API 체험을 위한 별도의 추가 무료 발송 건수는 제공되지 않습니다.

서식을 만들어보고, 토큰을 발급하고, 계약서 한 건을 직접 보내보세요.

API가 처음이라도 작은 테스트 하나부터 시작하면 우리 회사에서 어떤 방식으로 활용할 수 있을지 훨씬 구체적으로 확인할 수 있습니다.

이싸인온 API가 궁금했다면 지금 9월 체험 기간을 활용해 실제 업무 환경에서 직접 확인해보세요.

전자계약이 필요할 때, 이싸인온

이싸인온은 기업의 계약 업무를 더 쉽고 체계적으로 관리할 수 있도록 돕는 전자계약 서비스입니다.

▪️22년의 서비스 경험을 바탕으로

▪️200만 명 이상의 사용자가 이싸인온을 이용했으며,

▪️100만 건 이상의 전자문서 서명이 완료되었습니다.

계약서 작성부터 발송, 서명, 완료 문서 관리까지

업무 환경에 맞는 다양한 전자계약 기능을 활용할 수 있습니다.

전자계약이 처음이어도 어렵지 않습니다

처음 전자계약을 도입하는 기업부터 여러 부서에서 반복적으로 계약을 처리하는 기업까지, 이싸인온을 업무 방식에 맞게 활용할 수 있습니다.

도입 방법이나 필요한 기능이 궁금하다면 이싸인온 고객센터에 문의해 주세요.

▪️ 채널톡 문의 하기

▪️ 전화 상담: 02-3444-4660

📢 실무자를 위한 전자계약, 이싸인온