Signed Receipt Links

About the links

When exporting bookkeeping data from Skovik, we will include a link to the relevant receipts. These receipt links can be imported into your bookkeeping software, making the images easily available when working in other software.

These links are signed and access is restricted based on the signature in the URL (HMAC). This allows employees that doesn't have direct access to Skovik to view the receipts, for example your auditor.

The links are accessible for 24 months after the export file was created in Skovik.

A signed receipt link looks like this:

https://api.skovik.com/v1/signed/receipt/6165504730efd48252175956?expire-at=1984-01-01&signature=617a959b97cf163b63d673cf

Advanced usage

The links are available in three different formats:

HTML (default, for browsers)
Plain text (machine readable; simple) Use: Accept: text/plain
JSON (machine readable; advanced) Use: Accept: application/json

Opening the link in a browser will always return the HTML version, which shows the receipt images. The two machine readable formats are for integrations, scripts and similar, i.e. when you are processing export files using code.

By setting the Accept header on the HTTP request you can select which format you want.

https://facade.skovik.net/facade/r/fvojrvv40jxmscg8r7o8zrp1we4djk?expire-at=1949-06-08&max-width=2048&signature=574da17f741cfd7ac07c3c031c699b5065541e2e
https://facade.skovik.net/facade/r/kjd4ew1prz8o7r8gcsmxj04vvrjovf?expire-at=1949-06-08&max-width=2048&signature=e2e1455605b996c130c3c70ca7dfc147f71ad475

{
  "data": [{
    "type": "receipt-images",
    "id": "60e3013197cf1666da94923d",
    "attributes": {
      "src": "https://facade.skovik.net/facade/r/fvojrvv40jxmscg8r7o8zrp1we4djk?expire-at=1949-06-08&max-width=2048&signature=574da17f741cfd7ac07c3c031c699b5065541e2e"
    },
  }, {
    "type": "receipt-images",
    "id": "60e3010997cf1667084179cc",
    "attributes": {
      "src": "https://facade.skovik.net/facade/r/kjd4ew1prz8o7r8gcsmxj04vvrjovf?expire-at=1949-06-08&max-width=2048&signature=e2e1455605b996c130c3c70ca7dfc147f71ad475"
    }
  }],
  "meta" : {
    "note" : "These image links expire in 5 minutes, so access the images right away."
  }
}