정보 조회

문서 정보 조회

GET https://docs.esignon.net/api/v2/workflows/:workflowId

문서 id를 통해 문서의 작성 이력, 필드 목록, 작성자 목록, 참조자 목록을 포함한 상세 정보를 조회합니다.

Path Parameters

NameTypeDescription

workflowId

string

조회할 문서의 ID

Query Parameters

NameTypeDescription

offset

string

UTC offset ±hh:mm 형식으로 입력 (기본값 +09:00)

Headers

NameTypeDescription

Authentication

string

esignon ${인증토큰}

{
    "header":{
        "response_code": "/api/v2/workflows/:workflowId",
        "result_code": "00",
        "result_msg": "Success",
        "session_id": ""
    },
    "body":{
        "workflow_id": "{문서 id}",
        "workflow_name": "{문서명}",
        "workflow_status": "{문서 상태}",    
        "last_modify_date": "{마지막 작성일}",
        "expiry_date": "{문서 작성 기한}",
        "create_date": "{생성일}",
        "creator_email": "{생성자}",
        "creator_name": "{생성자 이메일}",
        "biz_id": "{부서 id}",
        "biz_name": "{부서명}",
        "action_history_list":[    // 작성 이력
            {
                "step_code": "{상태 코드}",
                "action_id": "{단계 id}",
                "confirm_date": "{작성일}",
                "name": "{작성자 이름}",
                "confirm_email": "{작성자 이메일}",
                "comment": "{메세지}",
            }
        ],
        "current_action_id": "{현재 작성 단계}",
        "total_action_count": "{문서 작성자 수}",
        "certificate_url": "{인증서 다운로드 url}",
        "download_url": "{문서 다운로드 url}",
        "view_url": "{문서 보기 url}",
        "referer_list":[    // 참조자 목록
            {
                "name": "{이름}",
                "type": "{참조 타입}",
                "email": "{이메일}",
            }
        ],
        "field_list":[    // 필드 목록
            {
                "action_id": "{단계 id}",
                "field_owner": "{필드명}",
                "field_value": "{입력값}",
                "email": "{이메일}",
            }
        ],
        "owner_list":[    // 생성자 목록
            {
                "action_id": "{단계 id}",
                "turn_yn": "{작성 차례 여부}",
                "name": "{이름}",
                "email": "{이메일}",
                "phone_number": "{핸드폰 번호}",
                "cert_mobile_yn": "{핸드폰 인증 여부}",
                "cert_password_yn": "{비밀번호 인증 여부}",
                "password_hint": "{비밀번호 힌트}",
            }
        ]
    }
}

Response

Status code

Code

Description

Reference

200

성공

형식이 잘못된 경우 header.result_msg 참조

400

연결 실패

Body

header.result_code

Code

Description

Reference

00

성공

성공

10

실패

문서 정보 조회가 실패했습니다. id를 확인하세요.

body.workflow_type

Value

Description

WEBTYPE

비대면

BULKTYPE

대량발송

FACEWEB

대면

body.workflow_status

Value

Description

Complete

완료

Canceled

취소

Playing

진행 중

Truncate

완전 삭제

Disposal

폐기

body.action_history_list.step_code

Value

Description

CERT_DOWN

이력 인증서 다운로드

DELETED

원본 PDF 삭제

DISPOSAL

폐기

DOC_DOWN

문서 다운로드

EXCEL_EXPORT

엑셀 다운로드

MOBILE_CERT

휴대폰 인증 완료

PASSWORD_CERT

비밀번호 인증 완료

PUBLIC_CERT

공인인증 서명 완료

RESEND

문서 재전송

SIGN_COMPLETE

서명 완료

SIGN_REQ

서명 요청

SIGN_RETURN

서명 반려

SIGN_START

서명 시작

TRUNCATE

문서 삭제

VIEW

문서 보기

WORKFLOW_CANCEL

문서 취소

WORKFLOW_COMPLETE

문서 완료

WORKFLOW_REJECT

문서 반려

WORKFLOW_START

문서 시작

body.referer_list.type

Value

Description

starter

생성자

referer

참조자

Last updated