REST API · Swagger-dokumentation
Det här kan du bygga
- CMS och bloggar: tidsstämpla varje artikel eller bild vid publicering.
- Design- och fotoverktyg: registrera varje export automatiskt.
- Dokumentflöden: fastställ exakt version av ett avtal, en offert eller en faktura.
- Kodpipelines: ta fingeravtryck av release-artefakter i CI.
- Marknadsplatser: ge säljare bevis på upphovsmannaskap för varje uppladdning.
Skaffa en nyckel
- Öppna https://run.secureauthor.com och logga in med Google.
- Öppna avsnittet API-nyckel och generera en nyckel.
- Kopiera nyckeln. Skicka den som query-parametern
api-key.
Fullständig referens: Swagger API-dokumentation.
Skapa ett kvitto
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
– multipart/form-data, fältet media = filen.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
Svar (förkortat):
{
"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– ett nytt kvitto har skapats.code: 1– filen har registrerats tidigare; det ursprungliga kvittot returneras.blockchainLinkärnullfram till nästa förankring och innehåller sedan länken till Polygonscan.nextEntryWritten– när posten väntas finnas i blockkedjan.
Kontrollera en fil
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
– fältet media = filen som ska kontrolleras, valfritt fält pdf = certifikatet.
Skicka antingen certifikatets PDF eller kvittots ID.
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) – filen stämmer med kvittot; false (code 1) – den stämmer inte.
Fel
| Svar | Betydelse |
|---|---|
{"code": 3, "error": "API key is missing"} | Lägg till ?api-key= i URL:en |
{"code": 3, "error": "Invalid API key"} | Generera en ny nyckel i webbappen |
| HTTP 400 | Ingen fil i fältet media eller felaktigt anrop |