REST API · Swagger डॉक्युमेंटेशन
तुम्ही काय तयार करू शकता
- CMS आणि ब्लॉग: प्रकाशित होताच प्रत्येक लेख किंवा प्रतिमेवर टाइमस्टॅम्प नोंदवा.
- डिझाइन आणि फोटो साधने: प्रत्येक एक्सपोर्ट आपोआप नोंदवा.
- दस्तऐवज प्रक्रिया: करार, ऑफर किंवा इनव्हॉइसची नेमकी आवृत्ती निश्चित करा.
- कोड पाइपलाइन: CI मध्ये रिलीज आर्टिफॅक्ट्सचा फिंगरप्रिंट घ्या.
- मार्केटप्लेस: प्रत्येक अपलोडसाठी विक्रेत्यांना लेखकत्वाचा पुरावा द्या.
की मिळवा
- https://run.secureauthor.com उघडा आणि Google ने साइन इन करा.
- API की विभाग उघडा आणि की तयार करण्याचे बटण (Generate API key) दाबा.
- की कॉपी करा. ती
api-keyquery पॅरामीटर म्हणून पाठवा.
संपूर्ण संदर्भ: 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— ही फाइल आधी नोंदवली गेली आहे; मूळ पावती परत दिली जाते.- पुढची नोंद होईपर्यंत
blockchainLinknullअसते, नंतर त्यात 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 फील्डमध्ये फाइल नाही किंवा विनंती चुकीची आहे |