Besplatan API za vremenske žigove

API SecureAuthor omogućuje vašem softveru da registrira i provjerava datoteke. Pošaljite datoteku metodom POST i dobit ćete račun s njezinim SHA-256 hashem i vremenskim žigom u UTC-u, koji se dvaput dnevno upisuje na blockchain Polygon; pošaljite datoteku s certifikatom ili ID-om računa i provjerite podudaraju li se. API je besplatan, javan i dokumentiran u Swaggeru.

Besplatan API ključ

REST API · Swagger dokumentacija

Što možete izgraditi

  • CMS i blogovi: vremenski žig za svaki članak ili sliku pri objavi.
  • Alati za dizajn i fotografiju: automatska registracija svakog izvoza.
  • Tokovi rada s dokumentima: fiksiranje točne verzije ugovora, ponude ili fakture.
  • Razvojni procesi: digitalni otisak artefakata izdanja u CI-ju.
  • Tržnice: dokaz autorstva za svaki prijenos prodavatelja.

Kako dobiti ključ

  1. Otvorite https://run.secureauthor.com i prijavite se s Googleom.
  2. Otvorite odjeljak „API ključ“ i pritisnite gumb za generiranje ključa.
  3. Kopirajte ključ. Prosljeđujte ga kao parametar upita api-key.

Potpuna referenca: API dokumentacija u Swaggeru.

Izrada računa

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

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

Odgovor (skraćeno):

{
  "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 — stvoren je novi račun.
  • code: 1 — ova je datoteka već registrirana; vraća se izvorni račun.
  • blockchainLink je null do sljedećeg upisa, a zatim sadrži poveznicu na Polygonscan.
  • nextEntryWritten — kada se očekuje zapis na blockchainu.

Provjera datoteke

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — polje media = datoteka koju provjeravate, neobavezno polje pdf = certifikat. Proslijedite ili PDF certifikat ili ID računa.

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) — datoteka odgovara računu; false (code 1) — ne odgovara.

Pogreške

OdgovorZnačenje
{"code": 3, "error": "API key is missing"}Dodajte ?api-key= u URL
{"code": 3, "error": "Invalid API key"}Ponovno generirajte ključ u web-aplikaciji
HTTP 400Nema datoteke u polju media ili je zahtjev neispravan

Česta pitanja

Koliko košta API?

Besplatan je. Nema plaćenih paketa ni objavljenih ograničenja broja zahtjeva; pristup se može obustaviti samo u slučaju zlouporabe, kako je opisano u Uvjetima korištenja.

Kako dobiti API ključ?

Prijavite se u web-aplikaciju s Googleom, otvorite odjeljak „API ključ“ i pritisnite gumb za generiranje ključa. Ključ možete ponovno generirati u bilo kojem trenutku; stari ključ tada prestaje vrijediti.

Mogu li umjesto datoteke poslati samo hash?

Trenutačni API prima samu datoteku, izračunava SHA-256 hash na poslužitelju i ne pohranjuje datoteku.

Jesu li računi iz API-ja isti kao računi iz web-aplikacije?

Da. Pojavljuju se u povijesti vašeg korisničkog računa i mogu se provjeriti u web-aplikaciji, proširenju ili putem API-ja.

Ažurirano:

Zaštitite sljedeću datoteku u nekoliko sekundi

Besplatan dokaz autorstva: SHA-256 hash, vremenski žig u UTC-u i zapis na blockchainu Polygon. Vaša se datoteka ne pohranjuje.

Dodaj u ChromeZaštitite datoteku