REST API · dokumentasi Swagger
Apa yang bisa Anda bangun
- CMS dan blog: beri stempel waktu pada setiap artikel atau gambar saat dipublikasikan.
- Alat desain dan foto: daftarkan setiap hasil ekspor secara otomatis.
- Alur kerja dokumen: kunci versi persis dari kontrak, penawaran, atau faktur.
- Pipeline kode: buat sidik jari artefak rilis di CI.
- Marketplace: beri penjual bukti kepengarangan untuk setiap unggahan.
Dapatkan kunci
- Buka https://run.secureauthor.com dan pilih Masuk dengan Google.
- Buka bagian Kunci API dan buat kunci baru.
- Salin kuncinya. Kirimkan sebagai parameter query
api-key.
Referensi lengkap: Dokumentasi API Swagger.
Membuat tanda terima
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
— multipart/form-data, field media = file Anda.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
Respons (diringkas):
{
"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— tanda terima baru dibuat.code: 1— file ini sudah pernah didaftarkan; tanda terima aslinya dikembalikan.blockchainLinkbernilainullsampai jadwal pencatatan berikutnya, lalu berisi tautan Polygonscan.nextEntryWritten— perkiraan waktu catatan masuk ke blockchain.
Memverifikasi file
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— field media = file yang diperiksa, field opsional pdf = sertifikatnya.
Kirimkan PDF sertifikat atau ID tanda terima.
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) — file cocok dengan tanda terima; false (code 1) — tidak cocok.
Kesalahan
| Respons | Artinya |
|---|---|
{"code": 3, "error": "API key is missing"} | Tambahkan ?api-key= ke URL |
{"code": 3, "error": "Invalid API key"} | Buat ulang kunci di aplikasi web |
| HTTP 400 | Tidak ada file di field media atau format permintaan salah |