generation of preview for business user

---

Greg-DB wrote:

...

By the way, sharingCreateSharedLink is deprecated in favor of sharingCreateSharedLinkWithSettings, so please use sharingCreateSharedLinkWithSettings if possible.

---

It's mentioned already multiple times by different users here on the forum, but let me recall again. When somebody needs a link to be received and it doesn't need to be new one, using sharingCreateSharedLinkWithSettings is pretty inconvenient. For existing link, it throws an error, that may contain the existing link, but that's not guaranteed. So for simple task to just get a link, developer will need to implement logic chain that may leads to second API call (sharingListSharedLinks) - something meaningless on my opinion too. This could be resolved as single boolean flag addition on top args level - let's say named "only_new_link" that is optional and defaults to true - the current behavior, so everything would be full back-compatible without affecting existing SDKs. 😉

I believe that in most cases, developers will set this flag to false, so a typical code (for typical use case) will be much simpler (and usually faster - not only possible, but guaranteed single API call for a link). Also, no need valid link to be received like an error as is now - much simpler code and easier error handling (real errors only).