API: preview.info

[igorsheg-wix]

Hey,

I'm trying to get the preview to work - to get an png of a layer.

I'm using preview.info

Getting https://previews.goabstract.com/projects/eda68300-e1d0-11e8-8133-0b70a3eae7f0/commits/51bf03f17a6234d6f703b86d2309fe5ae4a28034/files/D06C3330-664C-4F89-B8E6-AC27B93AF4DC/layers/4DF3A97D-3F66-48A1-9459-B42B3154391C

then when i try to access it I get {"error":"forbidden"}

maybe the documentation is unclear or I got something wrong.

Thanks in advance!

[tommoor]

Hey Igor, short answer is – use previews.raw to get the data and save it somewhere. The previews service requires authentication with a token which would have to be saved with the URL.

We're looking into how this can be improved (perhaps with a previews specific short-lived token) as we realize it's not as developer friendly as it should be.

[igorsheg-wix]

@tommoor Hey Tom, can you tell me why some preview.raw do return an array buffer, and some request return Error: Received status "404", expected 2XX [1] at AbstractAPI.fetch (/Users/igors/Development/ux-feed/node_modules/abstract-sdk/lib/AbstractAPI/index.js:294:13) [1] at process._tickCallback (internal/process/next_tick.js:68:7) [1] undefined

Thanks a lot.

[tommoor]

If you're receiving a 404 it means that the preview does not exist on the server.

There isn't a preview on the server for every commit, for efficiency we only store previews on commit where a layer has changed… so you may need to query the layer.info, and then use layer.lastChangedAtSha to find the last commit where the layer was altered – there should reliably be a preview for these commits.

[amccloud]

@igorsheg-wix you should also be able to pass sha: "latest" in the descriptor:

previews.raw({...layerDescriptor, sha: "latest"})

https://sdk.goabstract.com/docs/reference/#retrieve-a-preview

@tommoor this is really only documented in a code comment in the docs. I want to add a "Retrieve the latest preview" section to the docs but it would also be nice to have place to generally surface the concept of "latest" across all objects

[tommoor]

you should also be able to pass sha: "latest" in the descriptor

Ah, of course 🙈 – should have mentioned that too.

[igorsheg-wix]

@tommoor @amccloud Thanks guys ;)