REST API · Swagger docs
Ang puwede mong buuin
- CMS at blog: i-timestamp ang bawat artikulo o larawan pag-publish.
- Mga tool para sa disenyo at litrato: awtomatikong irehistro ang bawat export.
- Mga workflow ng dokumento: itala ang eksaktong bersyon ng kontrata, alok o invoice.
- Mga code pipeline: kunin ang fingerprint ng mga release artifact sa CI.
- Mga marketplace: bigyan ang mga seller ng patunay ng pagiging may-akda para sa bawat upload.
Kumuha ng key
- Buksan ang https://run.secureauthor.com at mag-sign in gamit ang Google.
- Buksan ang seksyong “API Key” at pindutin ang button para mag-generate ng key.
- Kopyahin ang key. Ipasa ito bilang query parameter na
api-key.
Buong reference: Swagger na dokumentasyon.
Gumawa ng resibo
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
— multipart/form-data, field na media = ang file.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
Response (pinaikli):
{
"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— nakagawa ng bagong resibo.code: 1— narehistro na ang file na ito dati; ibinabalik ang orihinal na resibo.nullangblockchainLinkhanggang sa susunod na takbo ng pagtatala, pagkatapos ay naglalaman na ito ng link sa Polygonscan.nextEntryWritten— kung kailan inaasahang maitatala sa blockchain.
Mag-verify ng file
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— field na media = ang file na susuriin, opsyonal na field na pdf = ang sertipiko.
Ipasa ang PDF na sertipiko o ang ID ng resibo.
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) — tugma ang file sa resibo; false (code 1) — hindi tugma.
Mga error
| Response | Kahulugan |
|---|---|
{"code": 3, "error": "API key is missing"} | Idagdag ang ?api-key= sa URL |
{"code": 3, "error": "Invalid API key"} | Mag-generate ng bagong key sa web app |
| HTTP 400 | Walang file sa field na media o mali ang anyo ng request |