REST API · Swagger डॉक्यूमेंटेशन
आप क्या बना सकते हैं
- CMS और ब्लॉग: पब्लिश होते ही हर लेख या इमेज का टाइमस्टैम्प।
- डिज़ाइन और फोटो टूल्स: हर एक्सपोर्ट को अपने-आप रजिस्टर करें।
- डॉक्यूमेंट वर्कफ़्लो: कॉन्ट्रैक्ट, ऑफ़र या इनवॉइस के सटीक वर्शन को दर्ज करें।
- कोड पाइपलाइन: CI में रिलीज़ आर्टिफ़ैक्ट्स का फिंगरप्रिंट।
- मार्केटप्लेस: विक्रेताओं को हर अपलोड के लिए लेखकत्व का प्रमाण दें।
कुंजी पाएं
- https://run.secureauthor.com खोलें और Google से साइन इन करें।
- “API कुंजी” सेक्शन खोलें और नई कुंजी जनरेट करने का बटन दबाएं।
- कुंजी कॉपी करें। इसे
api-keyक्वेरी पैरामीटर के रूप में भेजें।
पूरा रेफ़रेंस: 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— यह फ़ाइल पहले रजिस्टर हो चुकी है; मूल रसीद लौटाई जाती है।blockchainLinkअगले एंकरिंग रन तकnullरहता है, फिर उसमें 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 फ़ील्ड में फ़ाइल नहीं है या रिक्वेस्ट ग़लत है |