API gratuit de marcare temporală

API-ul SecureAuthor permite software-ului tău să înregistreze și să verifice fișiere. Trimite prin POST un fișier ca să creezi o chitanță cu hash-ul SHA-256 și marca temporală UTC, înregistrată în blockchainul Polygon de două ori pe zi; trimite un fișier cu un certificat sau un ID de chitanță ca să verifici dacă se potrivesc. API-ul este gratuit, public și documentat în Swagger.

Obține o cheie API gratuită

REST API · documentație Swagger

Ce poți construi

  • CMS și bloguri: pui o marcă temporală pe fiecare articol sau imagine la publicare.
  • Instrumente de design și foto: înregistrezi automat fiecare export.
  • Fluxuri de documente: fixezi versiunea exactă a unui contract, a unei oferte sau a unei facturi.
  • Pipeline-uri de cod: calculezi amprenta artefactelor de release în CI.
  • Marketplace-uri: le dai vânzătorilor o dovadă de autor pentru fiecare încărcare.

Obține o cheie

  1. Deschide https://run.secureauthor.com și autentifică-te cu Google.
  2. Deschide secțiunea „Cheie API” și generează cheia.
  3. Copiaz-o. Transmite-o ca parametru de interogare api-key.

Referință completă: „Documentația API în Swagger”.

Creează o chitanță

POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY — multipart/form-data, câmpul media = fișierul.

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

Răspuns (prescurtat):

{
  "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 — s-a creat o chitanță nouă.
  • code: 1 — acest fișier a fost înregistrat anterior; se returnează chitanța originală.
  • blockchainLink este null până la următoarea înregistrare în blockchain, apoi conține linkul Polygonscan.
  • nextEntryWritten — când este așteptată înregistrarea în blockchain.

Verifică un fișier

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — câmpul media = fișierul de verificat, câmpul opțional pdf = certificatul. Transmite fie certificatul PDF, fie ID-ul chitanței.

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) — fișierul se potrivește cu chitanța; false (code 1) — nu se potrivește.

Erori

RăspunsSemnificație
{"code": 3, "error": "API key is missing"}Adaugă ?api-key= în URL
{"code": 3, "error": "Invalid API key"}Regenerează cheia în aplicația web
HTTP 400Lipsește fișierul din câmpul media sau cererea este greșit formată

Întrebări frecvente

Cât costă API-ul?

Este gratuit. Nu există planuri plătite și nici limite de rată publicate; accesul poate fi suspendat doar în caz de abuz, așa cum scrie în Termenii de utilizare.

Cum obțin o cheie API?

Autentifică-te în aplicația web cu Google, deschide secțiunea „Cheie API” și generează cheia. O poți regenera oricând; cheia veche nu mai funcționează.

Pot trimite doar un hash în loc de fișier?

API-ul actual acceptă fișierul în sine, calculează hash-ul SHA-256 pe server și nu stochează fișierul.

Chitanțele din API sunt la fel ca cele din aplicația web?

Da. Apar în istoricul contului tău și pot fi verificate în aplicația web, în extensie sau prin API.

Actualizat:

Protejează-ți următorul fișier în câteva secunde

Dovadă de autor gratuită: hash SHA-256, marcă temporală UTC și o înregistrare în blockchainul Polygon. Fișierul tău nu este stocat.

Adaugă în ChromeProtejează un fișier