topic Re: API unification in Alfresco Archive

API unification

jonnyg — Mon, 21 Dec 2015 14:45:08 GMT

Pardon me if this has been raised elsewhere – but it would be of great help if the 2 API's are unified.We are customizing/extending the OOTB client code… which uses the so-call "internal" Rest API ("/app/rest/…") but we're going to need to change these all to use "api/enterprise/…" Won't be easy to

Re: API unification

jbarrez — Tue, 22 Dec 2015 11:37:50 GMT

The idea behind the two is:

- /rest is 'internal', ie what the UI uses. It used cookie auth.
- /api is the public api (ie we can't change this overnight). I'd say 80% of the features is the same, but there are a few UI-specific calls in /rest. It uses basic auth though.

So when writing 'external' applications, the /api is the way to go. This is the 'public', 'stable' API.

Re: API unification

jonnyg — Tue, 22 Dec 2015 13:43:47 GMT

Thanks. It would have been helpful if it were easier to go between the 2… i.e., if the public api is /api/enterprise, then the public API would be /x/api/enterprise.
We are extending/enhancing the OOTB application for our own use (converting it to a ui_grid + modal ux), and the less we need to change, the easier it will be to share back with you.