REST API · เอกสาร Swagger
สิ่งที่คุณสร้างได้
- CMS และบล็อก: ประทับเวลาให้ทุกบทความหรือรูปภาพเมื่อเผยแพร่
- เครื่องมือออกแบบและภาพถ่าย: ลงทะเบียนไฟล์ที่ส่งออกทุกครั้งโดยอัตโนมัติ
- เวิร์กโฟลว์เอกสาร: ยืนยันฉบับที่แน่นอนของสัญญา ใบเสนอราคา หรือใบแจ้งหนี้
- ไปป์ไลน์โค้ด: สร้างลายนิ้วมือดิจิทัลให้ไฟล์รีลีสใน CI
- มาร์เก็ตเพลส: มอบหลักฐานการเป็นผู้สร้างสรรค์ให้ผู้ขายสำหรับทุกการอัปโหลด
รับคีย์
- เปิด https://run.secureauthor.com และลงชื่อเข้าใช้ด้วย Google
- เปิดส่วน “คีย์ API” แล้วกดปุ่มสร้างคีย์ (Generate API key)
- คัดลอกคีย์ แล้วส่งเป็นพารามิเตอร์ query ชื่อ
api-key
เอกสารอ้างอิงฉบับเต็ม: เอกสาร API บน Swagger
สร้างใบเสร็จ
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จนถึงรอบบันทึกถัดไป จากนั้นจะมีลิงก์ PolygonscannextEntryWritten— เวลาที่คาดว่าระเบียนจะถูกบันทึกลงบล็อกเชน
ตรวจสอบไฟล์
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"} | เพิ่ม ?api-key= ลงใน URL |
{"code": 3, "error": "Invalid API key"} | สร้างคีย์ใหม่ในเว็บแอป |
| HTTP 400 | ไม่มีไฟล์ในฟิลด์ media หรือคำขอมีรูปแบบไม่ถูกต้อง |