REST API · Swagger-dokumentaatio
Mitä voit rakentaa
- Julkaisujärjestelmät ja blogit: aikaleimaa jokainen artikkeli tai kuva julkaisun yhteydessä.
- Suunnittelu- ja kuvatyökalut: rekisteröi jokainen vienti automaattisesti.
- Asiakirjatyönkulut: lukitse sopimuksen, tarjouksen tai laskun tarkka versio.
- Koodiputket: ota CI:ssä sormenjälki julkaisuartefakteista.
- Kauppapaikat: anna myyjille todiste tekijyydestä jokaisesta latauksesta.
Hanki avain
- Avaa https://run.secureauthor.com ja kirjaudu Googlella.
- Avaa API-avain-osio ja paina Luo API-avain.
- Kopioi avain. Välitä se kyselyparametrina
api-key.
Täydellinen viiteopas: Swagger API -dokumentaatio.
Luo kuitti
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
– multipart/form-data, kenttä media = tiedosto.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
Vastaus (lyhennetty):
{
"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– uusi kuitti luotu.code: 1– tämä tiedosto on rekisteröity aiemmin; alkuperäinen kuitti palautetaan.blockchainLinkonnullseuraavaan kirjausajoon asti, minkä jälkeen siinä on Polygonscan-linkki.nextEntryWritten– milloin merkinnän odotetaan olevan lohkoketjussa.
Tarkista tiedosto
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
– kenttä media = tarkistettava tiedosto, valinnainen kenttä pdf = todistus.
Välitä joko PDF-todistus tai kuitin tunnus.
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) – tiedosto vastaa kuittia; false (code 1) – ei vastaa.
Virheet
| Vastaus | Merkitys |
|---|---|
{"code": 3, "error": "API key is missing"} | Lisää URL-osoitteeseen ?api-key= |
{"code": 3, "error": "Invalid API key"} | Luo avain uudelleen verkkosovelluksessa |
| HTTP 400 | Kentässä media ei ole tiedostoa tai pyyntö on virheellinen |