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é
- Ouvrez https://run.secureauthor.com et connectez-vous avec Google.
- Ouvrez la section Clé API et appuyez sur Générer la clé API.
- 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é.blockchainLinkvautnulljusqu'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éponse | Signification |
|---|---|
{"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 400 | Aucun fichier dans le champ media ou requête mal formée |