API 명세서

개요

TSA서버로 PDF에 서명을 추가하는 TimeStamp 요청을 위한 API를 정의합니다.

API 목록

API 상세정보

1. 로컬 PDF파일 서명

WAS내부에 저장되어 있는 PDF파일을 타임스탬프 서명을 추가해서 다른 위치에 저장

* 유의사항 : API 사용을 위해서는 사본파일과 원본파일의 저장 위치가 TSA가 설치된 서버가 파일경로에 접근할 수 있는 동일 서버(Local)에 존재해야 사용 가능합니다.

URL

  • Method : POST

  • Endpoint : $SERVER/api/ext/signpdf

  • Content-Type: application/x-www-form-urlencoded

  • 입력 파라미터

응답

  • Content-Type: plain/text

  • HTTP status:

    • 200 성공

    • 400 잘못된 요청으로 인한 실패

    • 500 서버쪽 문제로 실패

  • BODY:

    • 성공시: 결과 파일명 (UTF-8 인코딩 바이트)

    • 실패시: 오류종류

오류 종류

샘플코드

2. 원격 PDF파일 서명

클라이언트가 업로드한 PDF파일을 타임스탬프 서명을 추가해서 반환

URL

  • Method : POST

  • Endpoint : $SERVER/api/ext/pdf/sign

  • Content-Type: multipart/form-data

  • 입력 파라미터

응답

  • Content-Type: application/json

  • HTTP status:

    • 200 성공

    • 400 잘못된 요청으로 인한 실패

    • 500 서버쪽 문제로 실패

  • BODY:

    • 성공시: SignResult

    • 실패시: 오류종류

SignResult

오류 종류

3. PDF파일 검증

클라이언트가 업로드한 PDF파일을 타임스탬프 서명을 추가해서 반환

URL

  • Method : GET

  • Endpoint : $SERVER/api/ext/pdf/sign

  • Content-Type: multipart/form-data

  • 입력 파라미터

응답

  • Content-Type: application/json

  • HTTP status:

    • 200 성공

    • 400 잘못된 요청으로 인한 실패

    • 500 서버쪽 문제로 실패

  • BODY:

    • 성공시: SignResult

    • 실패시: 오류종류

SignResult

오류 종류

Last updated