REST API · Swagger-dokumentasjon
Dette kan du bygge
- CMS og blogger: tidsstemple hver artikkel eller hvert bilde ved publisering.
- Design- og fotoverktøy: registrere hver eksport automatisk.
- Dokumentflyt: låse nøyaktig versjon av en kontrakt, et tilbud eller en faktura.
- Kodepipelines: ta fingeravtrykk av release-artefakter i CI.
- Markedsplasser: gi selgere bevis på opphav for hver opplasting.
Få en nøkkel
- Åpne https://run.secureauthor.com og logg inn med Google.
- Åpne delen API-nøkkel og generer en nøkkel.
- Kopier nøkkelen. Send den som spørringsparameteren
api-key.
Full referanse: Swagger-dokumentasjon.
Opprett en kvittering
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
— multipart/form-data, feltet 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 (forkortet):
{
"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– en ny kvittering er opprettet.code: 1– denne filen er registrert tidligere; den opprinnelige kvitteringen returneres.blockchainLinkernullfrem til neste forankring og inneholder deretter lenken til Polygonscan.nextEntryWritten– når registreringen forventes i blokkjeden.
Kontroller en fil
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— feltet media = filen som skal sjekkes, valgfritt felt pdf = sertifikatet.
Send enten PDF-sertifikatet eller kvitterings-ID-en.
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 stemmer med kvitteringen; false (code 1) – den gjør det ikke.
Feil
| Svar | Betydning |
|---|---|
{"code": 3, "error": "API key is missing"} | Legg til ?api-key= i URL-en |
{"code": 3, "error": "Invalid API key"} | Generer nøkkelen på nytt i nettappen |
| HTTP 400 | Ingen fil i feltet media, eller feil utformet forespørsel |