So after my first contact with using the SF API, I have some findings that I want to share.
Overall the API is lacking functionality which makes you need to jump through unnecessary hoops that should be easily fixed and make the experience of using it way more enjoyable.
Here’s my list of remarks and RFE’s.
The data api:
1 - Collections: When uploading a new model, we should also be able to add a collection argument, it’s absolutely non sensical we can’t do this. If options can be done via a callback like Patch call, why can’t we supply a collection name (which should either create a new collection or add to and existing one)
2 - Limits: Cursor limit of 24, I get it for personal use, but for enterprise use this makes no sense, we should be able to lift it as the workaround code is just a pain to deal with. I’d like to up the count on a call when I see fit. I just dealt with uploading 500 models, and it’s a pain.
3 - Options: We need more ‘options’ when uploading models, how come we can only set a few (rotation, shading, background) options via the data API, why not all viewer options, why is this prohibited in the first place!? I tried reading and replicating the PATCH command the SF 3D viewer sends, but I can’t get it to work with my own code. This means if I wanted shadow turned on for 500 models on the sketchfab site, I need to do it manually for 500 models (I don’t need a seperate site + viewer api for this particular batch).
4 - Sorting : Maybe add sort by name, the most basic of all sorting, all the other sorting options are mood for enterprise usage. Please add name sorting! It’s almost hard to believe this is a thing.
5 - Documentation : it’s a pain to use, not one example shows you how to implement proper cursor workflow. No info on limits with big batches, we just wait and see when it stops the processing and we have to manually resume after that.
6 - Swagger: Why not show the JSON body of the request you build? Results are nice, but it would be so much more intuitive if we can see the request body for notation of the request body.
If anything, please make all ‘options’ available for the viewer on the sketchfab site itself. Turn on shadows, post processing, the whole lot.
The main web UI:
1 - I can not search in my own models. I have 500 models all on private and I can use the search bar to search and find models in my own account. I’m just stupefied on how this came to be. You need to be able to manage your own collection of files right?!
2 - No multiselect in the UI for easy adding files to a collection or deleting many files at once. Please make the UI more friendly to work with.
These were my main issues with sketchfab. I love the viewer and the quality of it, but there’s a lot of room for improvement, and by reading other comments on the forum I’m not expecting much change anytime soon, but hopefully the development can focus a bit more on a more sensible approach to the whole API and working with a bigger volume of files.
Thanks for reading,