REST API · Swagger 문서
만들 수 있는 것
- CMS와 블로그: 게시할 때마다 모든 글과 이미지에 타임스탬프.
- 디자인·사진 도구: 내보낼 때마다 자동 등록.
- 문서 워크플로: 계약서, 제안서, 청구서의 정확한 버전 고정.
- 코드 파이프라인: CI에서 릴리스 결과물의 지문 기록.
- 마켓플레이스: 업로드마다 판매자에게 저작자 증명 제공.
키 받기
- **https://run.secureauthor.com**을 열고 Google로 로그인하세요.
- API 키 섹션을 열고 API 키 생성을 누르세요.
- 키를 복사해
api-key쿼리 매개변수로 전달하세요.
전체 레퍼런스: Swagger API 문서.
영수증 만들기
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
— multipart/form-data, 필드 media = 파일.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
응답(일부 생략):
{
"code": 0,
"message": "Receipt created successfully",
"receipt": {
"id": "cm8ixlzwf0002pj42vqmvev62",
"hash": "26be856c7aa5748040bcf998b18d3081cacb2ab1e4e3b34aece9e86152f083aa",
"timeStamp": "2025-03-21T15:25:13.599Z",
"blockchainLink": null,
"fileName": "artwork",
"fileMimeType": "png",
"fileSize": 26106,
"nextEntryWritten": "2025-03-22T00:00:00.000Z"
}
}
code: 0— 새 영수증이 만들어졌습니다.code: 1— 이미 등록된 파일이며, 처음 영수증이 반환됩니다.blockchainLink는 다음 기록 전까지null이고, 기록 후에는 Polygonscan 링크가 들어갑니다.nextEntryWritten— 블록체인 기록 예상 시각.
파일 검증
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— 필드 media = 확인할 파일, 선택 필드 pdf = 인증서.
인증서 PDF와 영수증 ID 중 하나를 전달하세요.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY&hash-id=cm8j56xxh0007pj42mj8eg7rl" \
-F "media=@artwork.png"
{
"code": 0,
"fileHash": "a535b2b5…d0",
"receiptHash": "a535b2b5…d0",
"receiptId": "cm8j56xxh0007pj42mj8eg7rl",
"isEqual": true
}
isEqual: true(code 0) — 파일이 영수증과 일치합니다. false(code 1) — 일치하지 않습니다.
오류
| 응답 | 의미 |
|---|---|
{"code": 3, "error": "API key is missing"} | URL에 ?api-key=를 추가하세요 |
{"code": 3, "error": "Invalid API key"} | 웹 앱에서 키를 다시 생성하세요 |
| HTTP 400 | media 필드에 파일이 없거나 요청 형식이 잘못됨 |