API ya bure ya muhuri wa muda

API ya SecureAuthor inaruhusu programu yako kusajili faili na kuzihakiki. Tuma faili kwa POST ili kuunda risiti yenye hash yake ya SHA-256 na muhuri wa muda wa UTC, inayoandikwa kwenye blockchain ya Polygon mara mbili kwa siku; tuma faili pamoja na cheti au ID ya risiti ili kuangalia kama vinalingana. API ni bure, ya umma na ina nyaraka kwenye Swagger.

Pata funguo ya API bure

REST API · nyaraka za Swagger

Unachoweza kujenga

  • CMS na blogu: weka muhuri wa muda kwenye kila makala au picha inapochapishwa.
  • Zana za ubunifu na picha: sajili kila export kiotomatiki.
  • Mtiririko wa nyaraka: hifadhi toleo kamili la mkataba, ofa au ankara.
  • Mifumo ya msimbo: weka alama ya kidole kwenye artifacts za matoleo ndani ya CI.
  • Masoko ya mtandaoni: wape wauzaji uthibitisho wa uandishi kwa kila upakiaji.

Pata funguo

  1. Fungua https://run.secureauthor.com na uingie kwa Google.
  2. Fungua sehemu ya Ufunguo wa API na ubonyeze kitufe cha kutengeneza funguo.
  3. Nakili funguo. Ipitishe kama kigezo cha query api-key.

Marejeo kamili: Nyaraka za API za Swagger.

Unda risiti

POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY — multipart/form-data, sehemu media = faili.

curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
  -F "media=@artwork.png"

Jibu (limefupishwa):

{
  "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 — risiti mpya imeundwa.
  • code: 1 — faili hii ilisajiliwa hapo awali; risiti ya awali inarudishwa.
  • blockchainLink ni null hadi mzunguko unaofuata wa kuandika, kisha ina kiungo cha Polygonscan.
  • nextEntryWritten — rekodi inatarajiwa kuandikwa kwenye blockchain lini.

Hakiki faili

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — sehemu media = faili ya kuhakiki, sehemu ya hiari pdf = cheti. Pitisha ama PDF ya cheti ama ID ya risiti.

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) — faili inalingana na risiti; false (code 1) — hailingani.

Hitilafu

JibuMaana
{"code": 3, "error": "API key is missing"}Ongeza ?api-key= kwenye URL
{"code": 3, "error": "Invalid API key"}Tengeneza funguo upya kwenye programu ya wavuti
HTTP 400Hakuna faili kwenye sehemu ya media au ombi lina muundo mbovu

Maswali yanayoulizwa mara kwa mara

API inagharimu kiasi gani?

Ni bure. Hakuna vifurushi vya kulipia wala vikomo vya maombi vilivyochapishwa; ufikiaji unaweza kusimamishwa tu kukiwa na matumizi mabaya, kama ilivyoelezwa kwenye Masharti ya Matumizi.

Nitapataje funguo ya API?

Ingia kwenye programu ya wavuti kwa Google, fungua sehemu ya Ufunguo wa API na ubonyeze kitufe cha kutengeneza funguo. Unaweza kuitengeneza upya wakati wowote; funguo ya zamani inaacha kufanya kazi.

Je, ninaweza kutuma hash tu badala ya faili?

API ya sasa inapokea faili yenyewe, inakokotoa hash ya SHA-256 kwenye seva na haihifadhi faili.

Je, risiti za API ni sawa na za wavuti?

Ndiyo. Zinaonekana kwenye historia ya akaunti yako na zinaweza kuhakikiwa kwenye programu ya wavuti, kiendelezi au kupitia API.

Imesasishwa:

Linda faili yako inayofuata kwa sekunde chache

Uthibitisho wa uandishi bure: hash ya SHA-256, muhuri wa muda wa UTC na rekodi kwenye blockchain ya Polygon. Faili yako haihifadhiwi.

Ongeza kwenye ChromeLinda faili