Gratis API voor tijdstempels

Met de API van SecureAuthor kan je software bestanden registreren en controleren. Stuur een bestand met POST om een ontvangstbewijs te maken met de SHA-256-hash en het UTC-tijdstempel, twee keer per dag verankerd op de Polygon-blockchain; stuur een bestand met een certificaat of ID van een ontvangstbewijs om te controleren of ze overeenkomen. De API is gratis, openbaar en gedocumenteerd in Swagger.

Vraag een gratis API-sleutel aan

REST API · Swagger-documentatie

Wat je kunt bouwen

  • CMS'en en blogs: zet bij publicatie een tijdstempel op elk artikel of elke afbeelding.
  • Ontwerp- en fototools: registreer elke export automatisch.
  • Documentworkflows: leg de exacte versie van een contract, offerte of factuur vast.
  • Code-pipelines: maak in CI een vingerafdruk van release-artefacten.
  • Marktplaatsen: geef verkopers bewijs van auteurschap voor elke upload.

Vraag een sleutel aan

  1. Open https://run.secureauthor.com en log in met Google.
  2. Open het onderdeel „API-sleutel” en druk op de knop om een sleutel te genereren (Generate API key).
  3. Kopieer de sleutel. Geef hem mee als queryparameter api-key.

Volledige referentie: Swagger API-documentatie.

Een ontvangstbewijs maken

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

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

Antwoord (ingekort):

{
  "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 — nieuw ontvangstbewijs gemaakt.
  • code: 1 — dit bestand is al eerder geregistreerd; je krijgt het oorspronkelijke ontvangstbewijs terug.
  • blockchainLink is null tot de volgende verankeringsronde en bevat daarna de link naar Polygonscan.
  • nextEntryWritten — wanneer het record naar verwachting op de blockchain staat.

Een bestand controleren

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — veld media = het bestand dat je wilt controleren, optioneel veld pdf = het certificaat. Geef de pdf van het certificaat of de ID van het ontvangstbewijs mee.

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) — het bestand komt overeen met het ontvangstbewijs; false (code 1) — het komt niet overeen.

Fouten

AntwoordBetekenis
{"code": 3, "error": "API key is missing"}Voeg ?api-key= toe aan de URL
{"code": 3, "error": "Invalid API key"}Genereer de sleutel opnieuw in de webapp
HTTP 400Geen bestand in het veld media of een onjuist opgebouwd verzoek

Veelgestelde vragen

Wat kost de API?

Niets. Er zijn geen betaalde abonnementen en geen gepubliceerde limieten op het aantal verzoeken; de toegang kan alleen bij misbruik worden opgeschort, zoals beschreven in de gebruiksvoorwaarden.

Hoe krijg ik een API-sleutel?

Log in de webapp in met Google, open het onderdeel „API-sleutel” en druk op de knop om een sleutel te genereren. Je kunt hem op elk moment opnieuw genereren; de oude sleutel werkt dan niet meer.

Kan ik alleen een hash sturen in plaats van het bestand?

De huidige API accepteert het bestand zelf, berekent de SHA-256-hash op de server en slaat het bestand niet op.

Zijn ontvangstbewijzen via de API hetzelfde als die via het web?

Ja. Ze verschijnen in de geschiedenis van je account en kunnen worden gecontroleerd in de webapp, de extensie of via de API.

Bijgewerkt:

Bescherm je volgende bestand in een paar seconden

Gratis bewijs van auteurschap: SHA-256-hash, UTC-tijdstempel en een record op de Polygon-blockchain. Je bestand wordt niet opgeslagen.

Toevoegen aan ChromeBescherm een bestand