API d'horodatage gratuite

L'API SecureAuthor permet à votre logiciel d'enregistrer des fichiers et de les vérifier. Envoyez un fichier en POST pour créer un reçu avec son hash SHA-256 et son horodatage UTC, ancré dans Polygon deux fois par jour ; envoyez un fichier avec un certificat ou un identifiant de reçu pour savoir s'ils correspondent. L'API est gratuite, publique et documentée dans Swagger.

Obtenir une clé API gratuite

API REST · documentation Swagger

Ce que vous pouvez construire

  • CMS et blogs : horodatez chaque article ou image à la publication.
  • Outils de design et de photo : enregistrez automatiquement chaque export.
  • Flux documentaires : figez la version exacte d'un contrat, d'une offre ou d'une facture.
  • Pipelines de code : prenez l'empreinte des artefacts de release dans la CI.
  • Places de marché : donnez aux vendeurs une preuve d'antériorité pour chaque fichier mis en ligne.

Obtenir une clé

  1. Ouvrez https://run.secureauthor.com et connectez-vous avec Google.
  2. Ouvrez la section Clé API et appuyez sur Générer la clé API.
  3. Copiez la clé. Transmettez-la dans le paramètre de requête api-key.

Référence complète : documentation Swagger.

Créer un reçu

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

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

Réponse (abrégée) :

{
  "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 : nouveau reçu créé.
  • code: 1 : ce fichier a déjà été enregistré ; le reçu d'origine est renvoyé.
  • blockchainLink vaut null jusqu'au passage d'ancrage suivant, puis contient le lien Polygonscan.
  • nextEntryWritten : heure prévue de l'enregistrement dans la blockchain.

Vérifier un fichier

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — champ media = le fichier à vérifier, champ facultatif pdf = le certificat. Transmettez soit le certificat PDF, soit l'identifiant du reçu.

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) : le fichier correspond au reçu ; false (code 1) : il ne correspond pas.

Erreurs

RéponseSignification
{"code": 3, "error": "API key is missing"}Ajoutez ?api-key= à l'URL
{"code": 3, "error": "Invalid API key"}Régénérez la clé dans l'application web
HTTP 400Aucun fichier dans le champ media ou requête mal formée

Questions fréquentes

Combien coûte l'API ?

Elle est gratuite. Il n'y a ni offre payante ni limite de débit publiée ; l'accès ne peut être suspendu qu'en cas d'abus, comme le prévoient les conditions d'utilisation.

Comment obtenir une clé API ?

Connectez-vous à l'application web avec Google, ouvrez la section « Clé API » et appuyez sur « Générer la clé API ». Vous pouvez la régénérer à tout moment ; l'ancienne clé cesse alors de fonctionner.

Puis-je envoyer seulement un hash au lieu du fichier ?

L'API actuelle accepte le fichier lui-même, calcule le hash SHA-256 sur le serveur et ne conserve pas le fichier.

Les reçus créés par l'API sont-ils les mêmes que ceux du web ?

Oui. Ils apparaissent dans l'historique de votre compte et peuvent être vérifiés dans l'application web, dans l'extension ou via l'API.

Mis à jour:

Protégez votre prochain fichier en quelques secondes

Preuve d'antériorité gratuite : hash SHA-256, horodatage UTC et enregistrement dans la blockchain Polygon. Votre fichier n'est pas conservé.

Ajouter à ChromeProtéger un fichier