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
- Deschide https://run.secureauthor.com și autentifică-te cu Google.
- Deschide secțiunea „Cheie API” și generează cheia.
- 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ă.blockchainLinkestenullpâ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ăspuns | Semnificaț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 400 | Lipsește fișierul din câmpul media sau cererea este greșit formată |