REST API · τεκμηρίωση Swagger
Τι μπορείτε να φτιάξετε
- CMS και blogs: χρονοσφραγίδα σε κάθε άρθρο ή εικόνα κατά τη δημοσίευση.
- Εργαλεία σχεδίασης και φωτογραφίας: αυτόματη καταχώριση κάθε export.
- Ροές εργασίας εγγράφων: καταγραφή της ακριβούς έκδοσης μιας σύμβασης, προσφοράς ή τιμολογίου.
- Pipelines κώδικα: αποτύπωμα των release artifacts στο CI.
- Marketplaces: απόδειξη πατρότητας για κάθε ανέβασμα των πωλητών σας.
Αποκτήστε κλειδί
- Ανοίξτε το https://run.secureauthor.com και συνδεθείτε με το Google.
- Ανοίξτε την ενότητα «Κλειδί API» και πατήστε «Δημιουργία κλειδιού API».
- Αντιγράψτε το κλειδί. Περάστε το ως παράμετρο ερωτήματος
api-key.
Πλήρης αναφορά: τεκμηρίωση 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μέχρι τον επόμενο κύκλο καταγραφής και μετά περιέχει τον σύνδεσμο του Polygonscan. nextEntryWritten— πότε αναμένεται η εγγραφή στο blockchain.
Επαλήθευση αρχείου
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— πεδίο media = το αρχείο προς έλεγχο, προαιρετικό πεδίο pdf = το πιστοποιητικό.
Περάστε είτε το PDF του πιστοποιητικού είτε τον αριθμό απόδειξης.
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"} | Δημιουργήστε νέο κλειδί στην εφαρμογή web |
| HTTP 400 | Δεν υπάρχει αρχείο στο πεδίο media ή το αίτημα είναι λανθασμένο |