இலவச நேர முத்திரை API

SecureAuthor API உங்கள் மென்பொருள் கோப்புகளைப் பதிவு செய்யவும் சரிபார்க்கவும் உதவுகிறது. ஒரு கோப்பை POST செய்தால், அதன் SHA-256 ஹாஷும் UTC நேர முத்திரையும் கொண்ட ரசீது உருவாகும்; அது நாளுக்கு இருமுறை Polygon பிளாக்செயினில் பதிவாகும். கோப்பைச் சான்றிதழ் அல்லது ரசீது ஐடியுடன் POST செய்தால் அவை பொருந்துகின்றனவா என்று தெரியும். API இலவசம், பொதுவானது, Swagger-இல் ஆவணப்படுத்தப்பட்டது.

நீங்கள் என்ன உருவாக்கலாம்

  • CMS மற்றும் வலைப்பதிவுகள்: வெளியிடும்போதே ஒவ்வொரு கட்டுரைக்கும் படத்துக்கும் நேர முத்திரை.
  • வடிவமைப்பு மற்றும் புகைப்படக் கருவிகள்: ஒவ்வொரு ஏற்றுமதியையும் (export) தானாகப் பதிவு செய்தல்.
  • ஆவணப் பணிப்பாய்வுகள்: ஒப்பந்தம், சலுகை அல்லது இன்வாய்ஸின் சரியான பதிப்பை நிலைநிறுத்துதல்.
  • குறியீட்டுப் பைப்லைன்கள்: CI-இல் வெளியீட்டுக் கோப்புகளுக்கு (release artifacts) கைரேகை.
  • மார்க்கெட்பிளேஸ்கள்: ஒவ்வொரு பதிவேற்றத்துக்கும் விற்பனையாளர்களுக்குப் படைப்புரிமைச் சான்று.

சாவியைப் பெறுங்கள்

  1. https://run.secureauthor.com ஐத் திறந்து Google மூலம் உள்நுழையுங்கள்.
  2. “API சாவி” பகுதியைத் திறந்து, API சாவியை உருவாக்கும் பொத்தானை அழுத்துங்கள்.
  3. சாவியை நகலெடுங்கள். அதை api-key query அளவுருவாக அனுப்புங்கள்.

முழு விவரம்: 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 — பதிவு பிளாக்செயினில் எப்போது எதிர்பார்க்கப்படுகிறது.

கோப்பைச் சரிபார்த்தல்

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"}URL-இல் ?api-key= சேர்க்கவும்
{"code": 3, "error": "Invalid API key"}வெப் ஆப்பில் சாவியை மீண்டும் உருவாக்கவும்
HTTP 400media புலத்தில் கோப்பு இல்லை அல்லது கோரிக்கை தவறான வடிவில் உள்ளது

அடிக்கடி கேட்கப்படும் கேள்விகள்

API-க்கு என்ன செலவாகும்?

இது இலவசம். கட்டணத் திட்டங்களோ வெளியிடப்பட்ட கோரிக்கை வரம்புகளோ இல்லை; பயன்பாட்டு விதிமுறைகளில் விவரித்தபடி, தவறான பயன்பாடு இருந்தால் மட்டுமே அணுகல் நிறுத்தப்படலாம்.

API சாவியை எப்படிப் பெறுவது?

வெப் ஆப்பில் Google மூலம் உள்நுழைந்து, “API சாவி” பகுதியைத் திறந்து, API சாவியை உருவாக்கும் பொத்தானை அழுத்துங்கள். எப்போது வேண்டுமானாலும் புதிய சாவியை உருவாக்கலாம்; பழைய சாவி வேலை செய்வது நின்றுவிடும்.

கோப்புக்குப் பதிலாக ஹாஷை மட்டும் அனுப்ப முடியுமா?

தற்போதைய API கோப்பையே ஏற்றுக்கொள்கிறது, SHA-256 ஹாஷைச் சர்வரில் கணக்கிடுகிறது, கோப்பைச் சேமிப்பதில்லை.

API ரசீதுகளும் வெப் ரசீதுகளும் ஒன்றா?

ஆம். அவை உங்கள் கணக்கு வரலாற்றில் தெரியும்; வெப் ஆப், நீட்டிப்பு அல்லது API மூலம் சரிபார்க்கலாம்.

புதுப்பிக்கப்பட்டது:

உங்கள் அடுத்த கோப்பைச் சில விநாடிகளில் பாதுகாக்கவும்

இலவசப் படைப்புரிமைச் சான்று: SHA-256 ஹாஷ், UTC நேர முத்திரை, Polygon பிளாக்செயின் பதிவு. உங்கள் கோப்பு சேமிக்கப்படுவதில்லை.

Chrome-இல் சேர்கோப்பைப் பாதுகாக்கவும்