topic Re: /alfresco/api versus /alfresco/slingshot in Alfresco Forum

/alfresco/api versus /alfresco/slingshot

lngtai001 — Wed, 15 Feb 2017 12:16:24 GMT

We upgraded from Alfresco 4.2.2 to Alfresco 5.1.1.Our "view in browser" links went from http://<hostname>:<port>/share/proxy/api/nodeto http://<hostname>:<port>/share/proxy/slingshot/nodewe can still use either link.Why did it change? What is the difference?We have third part

Re: /alfresco/api versus /alfresco/slingshot

afaust — Wed, 15 Feb 2017 19:22:45 GMT

Alfresco has made a couple of efforts to better distinguish "public APIs" that should be safe for integration with external applications, and "internal APIs" that only exist to be used via Alfresco Share. "slingshot" is the historic, low-level project name for Share, and anything that is related to "slingshot" should be considered "internal API", which might change without notice from one version to another, and is thus not safe for integrations.

For Alfresco 5.1. you can read about the public ReST API in the documentation. With Alfresco 5.2 they have introduced a formal v1 ReST API.

Re: /alfresco/api versus /alfresco/slingshot

jpotts — Wed, 15 Feb 2017 22:22:23 GMT

Some web scripts have a "lifecycle" that indicates whether they are internal, draft public, or public. I agree with Axel that you should avoid using any of the slingshot URLs. But you should also get in the habit of checking that lifecycle so that you don't inadvertently use an internal API regardless of whether it is "slingshot" or not.