서명자의 서명 내용 수정 요청하기
서명 내용 수정 요청은 이미 서명을 완료한 참여자에게 자신이 입력한 서명 내용을 다시 입력해 달라고 요청하는 기능입니다. 참여자가 계약 문서에 값을 잘못 입력했거나 다시 입력하고 싶을 때, 서명 내용 수정 요청 API로 해당 참여자의 입력란을 다시 받을 수 있습니다.
유의사항
- 이 기능은 문서 내용을 바꾸는 '문서 수정'이 아니라, 참여자의 서명 내용을 다시 받기 위한 '재서명 요청'입니다.
- 수정 요청 시 대상 참여자 이후의 서명이 무효화되어 다시 서명이 진행됩니다.
- 2024년 2월 2일 이후 진행된 서명 요청 건부터 사용할 수 있습니다.
'문서 수정'이 아니라 '서명 내용 수정 요청'입니다이 기능은 문서(계약서)의 양식·조항·내용 자체를 바꾸는 것이 아닙니다. 참여자가 서명 과정에서 입력한 값(입력란 내용)을 다시 받기 위해 재서명을 요청하는 기능입니다.
구분 문서 수정 (내용 수정) 서명 내용 수정 요청 (이 문서) 목적 요청자가 제목·파일·참여자·입력란 등 문서 내용을 변경 참여자가 입력한 서명 내용을 다시 입력받음 대상 문서 자체 이미 서명한 참여자 결과 문서 내용이 바뀜 대상 참여자와 그 이후 서명자가 재서명 엔드포인트 POST /documents/{documentId}/start-modification등 (내용 수정하기)POST /documents/{documentId}/request-correction문서의 제목·파일·참여자·입력란 등 내용 자체를 바꾸려면 이 문서가 아니라 내용 수정하기 문서를 참고하세요. 그 기능은 수정 시작 → 데이터 변경(PATCH) → 수정 완료/취소의 별도 흐름으로 동작합니다.
전체 흐름
진행 중인 문서에서 특정 참여자에게 수정을 요청하면, 그 참여자와 이후 서명자들이 다시 서명하게 됩니다. 아래 흐름도에서 파랑은 서버·API 처리 단계, 민트는 사용자 화면·완료 단계를 의미합니다.
- 진행 중 문서 — 2명 이상, 서명 순서가 지정된 진행 중(
ON_GOING) 문서인지 확인합니다. POST /documents/{documentId}/request-correction— 수정을 요청할 참여자(participantId)와 남길 말(message)을 담아 요청합니다.- 재서명 진행 — 대상 참여자와 그 이후에 서명한 참여자들의 서명이 무효화되고, 다시 서명을 진행합니다. 이전 입력값이 그대로 노출됩니다.
- 서명 완료 — 모든 참여자가 다시 서명을 마치면 문서가 완료(
COMPLETED)됩니다.
수정을 요청받은 참여자뿐 아니라, 그 이전에 서명을 완료한 참여자도 다시 서명해야 합니다.
예를 들어 참여자 A → B → C → D 순서로 요청하여 A·B·C가 서명을 완료한 상황에서 A에게 수정을 요청하면, A뿐 아니라 B·C도 다시 서명을 진행합니다. 참여자에게는 이전에 입력했던 값이 동일하게 노출되므로 수정과 확인이 쉽습니다.
1. 수정 요청 조건
다음 조건을 모두 만족하는 문서에서만 수정 요청이 가능합니다.
- 참여자가 2명 이상인 문서
- 모든 참여자의 서명이 완료되지 않은 진행 중(
ON_GOING) 문서 - 서명 순서가 지정된 문서 (순서 없는 서명이 적용된 문서는 수정 요청 불가)
보안링크(
SECURE_LINK) 서명 수단은 참여자의 연락처로 서명 링크를 전송하지 않습니다.
2. 수정 요청 API 호출하기
문서 ID를 경로에, 수정을 요청할 참여자 ID와 남길 말을 본문에 담아 요청합니다.
curl -X POST 'https://api.modusign.co.kr/documents/{documentId}/request-correction' \
-H 'Authorization: Basic {인코딩된 API-KEY}' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"participantId": "{participantId}",
"message": "생년월일을 다시 입력해 주세요."
}'요청 항목
| 항목 | 위치 | 설명 | 필수 |
|---|---|---|---|
documentId | 경로(path) | 수정 요청할 문서의 ID | 필수 |
participantId | 본문(body) | 수정을 요청할 참여자의 ID | 필수 |
message | 본문(body) | 참여자에게 전달할 남길 말 (1~1000자) | 필수 |
본문 항목 이름은
participantId입니다. (participantdId처럼 오타가 있으면 요청이 실패합니다.)message는 필수이며, 1자 이상 1000자 이하로 입력해야 합니다.
응답 예시
요청이 성공하면 200과 함께 갱신된 문서 정보(제목, 요청자, 참여자, 서명 현황, 파일 등)가 반환됩니다. 응답 구조는 아래와 같습니다.
{
"id": "DOCUMENT_ID",
"title": "문서제목",
"status": "{문서 상태}",
"requester": { "email": "[email protected]", "name": "최모두" },
"participants": [
{
"id": "PARTICIPANT_ID_1",
"type": "SIGNER",
"name": "김모두",
"signingOrder": 1,
"signingMethod": { "type": "EMAIL", "value": "[email protected]" },
"locale": "ko"
},
{
"id": "PARTICIPANT_ID_2",
"type": "SIGNER",
"name": "이모두",
"signingOrder": 2,
"signingMethod": { "type": "EMAIL", "value": "[email protected]" },
"locale": "ko"
}
],
"currentSigningOrder": 1,
"signings": [],
"accessibleByParticipant": true,
"abort": null,
"updatedAt": "2024-04-12",
"createdAt": "2024-04-12",
"file": { "downloadUrl": "https://..." },
"auditTrail": null
}확인 필요 — 수정 요청 직후의 정확한
status·currentSigningOrder·signings값은 공식 문서에 명시돼 있지 않습니다. 실제 응답으로 확인 후 확정해 주세요. (연동 시에는 응답의status를 그대로 신뢰하기보다 문서 상세 조회로 재확인하는 것을 권장합니다.)
3. API 호출 시 주의사항
- 수정 요청 조건을 먼저 확인하세요. 참여자 2명 이상, 서명 순서 지정, 진행 중(
ON_GOING) 문서여야 합니다. - 대상 참여자 이후의 서명이 모두 무효화됩니다. 수정을 요청받은 참여자뿐 아니라 이후 서명자도 다시 서명해야 합니다.
- 2024년 2월 2일 이후 진행된 서명 요청 건부터 사용할 수 있습니다.
- 보안링크(
SECURE_LINK) 는 참여자의 연락처로 서명 링크를 전송하지 않습니다. - API KEY는 서버사이드 전용입니다. 브라우저 등 클라이언트에 노출하지 마세요.
자주 발생하는 오류
| 응답 | 에러 메시지 | 원인 | 해결 방법 |
|---|---|---|---|
| 401 | Unauthorized | API KEY 또는 인증 헤더 오류 | API KEY와 Authorization 헤더(Basic 인코딩) 확인 |
| 404 | Not found | 존재하지 않는 문서 ID 또는 참여자 ID | documentId·participantId 확인 |
| 422 | Document status is invalid 등 (상황별 상이) | 수정 요청 조건 미충족(순서 없는 서명, 참여자 1명, 완료된 문서 등) 또는 본문 형식 오류 | 조건과 participantId·message 형식 확인 |
| 429 | Too Many Requests | Rate Limit 초과 | X-Retry-After(초)만큼 대기 후 재시도 |
4. 자주 묻는 질문
FAQ
이 기능으로 문서(계약서)의 내용을 바꿀 수 있나요?
아니요. 서명 내용 수정 요청은 문서의 양식·조항 등 내용을 바꾸는 기능이 아닙니다. 참여자가 서명 과정에서 입력한 값을 다시 입력받기 위해 재서명을 요청하는 기능입니다. 문서의 제목·파일·참여자·입력란 등 내용 자체를 바꾸려면 내용 수정하기 기능을 사용하세요.
수정을 요청하면 누가 다시 서명하나요?
수정을 요청받은 참여자와, 그 이전에 서명을 완료한 참여자가 함께 다시 서명합니다. 예를 들어 A·B·C가 서명한 상태에서 A에게 요청하면 A·B·C 모두 재서명합니다. 이전 입력값은 그대로 노출됩니다.
순서 없는 서명 문서에도 수정 요청을 보낼 수 있나요?
아니요. 서명 순서가 지정된 문서에서만 가능합니다. 순서 없는 서명이 적용된 문서는 수정 요청을 사용할 수 없습니다.
수정 요청이 실패합니다(422). 무엇을 확인해야 하나요?
수정 요청 조건을 충족하지 않으면 실패합니다.
응답 예시:
{
"statusCode": 422,
"message": "Document status is invalid"
}- 참여자가 2명 이상인지, 서명 순서가 지정됐는지, 진행 중(
ON_GOING) 문서인지 확인하세요. - 2024년 2월 2일 이후 진행된 서명 요청 건인지 확인하세요.
- 본문의
participantId·message가 올바른지 확인하세요. (message는 필수)
더 자세한 API 내용은 API References에서 확인하세요!서명 내용 수정 요청 API의 요청·응답 스키마를 확인하세요.
Updated 4 days ago