സൗജന്യ ടൈംസ്റ്റാമ്പിംഗ് API

SecureAuthor API ഉപയോഗിച്ച് നിങ്ങളുടെ സോഫ്റ്റ്‌വെയറിന് ഫയലുകൾ രജിസ്റ്റർ ചെയ്യാനും പരിശോധിക്കാനും കഴിയും. ഒരു ഫയൽ POST ചെയ്താൽ അതിന്റെ SHA-256 ഹാഷും UTC ടൈംസ്റ്റാമ്പുമുള്ള രസീത് ഉണ്ടാകും, അത് ദിവസം രണ്ടുതവണ Polygon ബ്ലോക്ക്‌ചെയിനിൽ രേഖപ്പെടുത്തും; ഒത്തുപോകുന്നുണ്ടോ എന്ന് നോക്കാൻ ഫയലും സർട്ടിഫിക്കറ്റോ രസീത് ID-യോ POST ചെയ്യുക. API സൗജന്യവും പബ്ലിക്കുമാണ്, Swagger-ൽ ഡോക്യുമെന്റ് ചെയ്തിട്ടുണ്ട്.

സൗജന്യ API കീ നേടുക

REST API · Swagger ഡോക്യുമെന്റേഷൻ

നിങ്ങൾക്ക് എന്തൊക്കെ നിർമ്മിക്കാം

  • CMS-ഉം ബ്ലോഗുകളും: പ്രസിദ്ധീകരിക്കുമ്പോൾ ഓരോ ലേഖനത്തിനും ചിത്രത്തിനും ടൈംസ്റ്റാമ്പ്.
  • ഡിസൈൻ, ഫോട്ടോ ടൂളുകൾ: ഓരോ എക്സ്പോർട്ടും സ്വയമേവ രജിസ്റ്റർ ചെയ്യുക.
  • ഡോക്യുമെന്റ് വർക്ക്ഫ്ലോകൾ: ഒരു കരാറിന്റെയോ ഓഫറിന്റെയോ ഇൻവോയ്സിന്റെയോ കൃത്യമായ പതിപ്പ് ഉറപ്പിക്കുക.
  • കോഡ് പൈപ്പ്‌ലൈനുകൾ: CI-യിൽ റിലീസ് ആർട്ടിഫാക്റ്റുകളുടെ ഫിംഗർപ്രിന്റ് എടുക്കുക.
  • മാർക്കറ്റ്‌പ്ലേസുകൾ: ഓരോ അപ്‌ലോഡിനും വിൽപ്പനക്കാർക്ക് കർതൃത്വത്തിന്റെ തെളിവ് നൽകുക.

കീ നേടുക

  1. https://run.secureauthor.com തുറന്ന് Google ഉപയോഗിച്ച് സൈൻ ഇൻ ചെയ്യുക.
  2. “API കീ” വിഭാഗം തുറന്ന് പുതിയ കീ ജനറേറ്റ് ചെയ്യാനുള്ള ബട്ടൺ അമർത്തുക.
  3. കീ കോപ്പി ചെയ്യുക. അത് api-key എന്ന query പാരാമീറ്ററായി നൽകുക.

പൂർണ റഫറൻസ്: 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 400media ഫീൽഡിൽ ഫയൽ ഇല്ല, അല്ലെങ്കിൽ അഭ്യർത്ഥന തെറ്റായ രൂപത്തിലാണ്

പതിവ് ചോദ്യങ്ങൾ

API-ക്ക് എത്ര ചെലവാകും?

ഇത് സൗജന്യമാണ്. പണമടച്ചുള്ള പ്ലാനുകളോ പ്രസിദ്ധീകരിച്ച റേറ്റ് ലിമിറ്റുകളോ ഇല്ല; ഉപയോഗ നിബന്ധനകളിൽ പറഞ്ഞതുപോലെ ദുരുപയോഗം ഉണ്ടായാൽ മാത്രമേ ആക്സസ് നിർത്തിവെക്കൂ.

API കീ എങ്ങനെ നേടാം?

വെബ് ആപ്പിൽ Google ഉപയോഗിച്ച് സൈൻ ഇൻ ചെയ്യുക, “API കീ” വിഭാഗം തുറന്ന് പുതിയ കീ ജനറേറ്റ് ചെയ്യാനുള്ള ബട്ടൺ അമർത്തുക. എപ്പോൾ വേണമെങ്കിലും അത് വീണ്ടും ജനറേറ്റ് ചെയ്യാം; പഴയ കീ പ്രവർത്തിക്കാതാകും.

ഫയലിന് പകരം ഹാഷ് മാത്രം അയയ്ക്കാമോ?

നിലവിലെ API ഫയൽ തന്നെയാണ് സ്വീകരിക്കുന്നത്; അത് സെർവറിൽ SHA-256 ഹാഷ് കണക്കാക്കുന്നു, ഫയൽ സൂക്ഷിക്കുന്നില്ല.

API രസീതുകളും വെബ് രസീതുകളും ഒന്നാണോ?

അതെ. അവ നിങ്ങളുടെ അക്കൗണ്ട് ചരിത്രത്തിൽ കാണാം; വെബ് ആപ്പിലോ എക്സ്റ്റൻഷനിലോ API വഴിയോ പരിശോധിക്കാം.

പുതുക്കിയത്:

നിങ്ങളുടെ അടുത്ത ഫയൽ നിമിഷങ്ങൾക്കുള്ളിൽ സംരക്ഷിക്കുക

കർതൃത്വത്തിന്റെ സൗജന്യ തെളിവ്: SHA-256 ഹാഷ്, UTC ടൈംസ്റ്റാമ്പ്, Polygon ബ്ലോക്ക്‌ചെയിൻ രേഖ. നിങ്ങളുടെ ഫയൽ സൂക്ഷിക്കുന്നില്ല.

Chrome-ലേക്ക് ചേർക്കുകഫയൽ സംരക്ഷിക്കുക