Possible bug while checking in via REST API?

n4zroth — Mon, 21 Sep 2015 01:50:45 GMT

Hi,I'm trying to check in a document via REST-Api and I always get the error that I don't have the appropriate permissions to perform the operation. Problem is that the checkin actually completes.Application flow is the following:Checkout via service/slingshot/doclib/action/checkout/node/Upload of n

Re: Possible bug while checking in via REST API?

resplin — Thu, 08 Oct 2015 22:54:14 GMT

This problem was reported in the issue tracker as https://issues.alfresco.com/jira/browse/ALF-21447

I'm copying the key comment here for reference, because it is so useful.

From Gabriele Columbro:
<blockquote>
I completely understand your frustration. And I completely agree this is not entirely your fault, it is mostly our fault not having had a clear statement of what APIs are public, private, or even internal.

Nevertheless, in all fairness, those APIs (starting with /slingshot):

1. have never been documented on docs.alfresco.com (see http://docs.alfresco.com/5.0/references/RESTful-intro.html), which has been always the place to find supported features
2. in the very same page you reference, they are actually all marked with family "internal", which hints very clearly they are not "public". Have a look at the different "families" (http://localhost:8080/alfresco/service/index/lifecycle/) to get a clearer idea and get the full picture . . .

Said that, I repeat, we acknowledge lots of work needed to be done in this area, and so when I took over the role of PM for the Dev Platform, about 1 year ago, I set my self the objective to first clarify all of this before entertaining major new developments on our API, because as a consultant, community implementor and earlier in the days partner of Alfresco, I have been bitten by this.

This has resulted in 5.1 (and will result even more with 5.1 Enterprise) in:

* All webscripts based API that are not explicitly public are already marked in 5.1.b with 'limitedSupport', indicating their deprecation
* A support status will be added soon to http://www.alfresco.com/services/subscription/technical-support/product-support-status to indicate support status of each API
* For the APIs in full support I am setting a clear API compatibility policy which will ensure your customization work for a clearly predictable amount of time (I am looking at least a major version).

So, to your point, yes we have put in an extensive amount of work, to actually fix the public APIs and to make sure we communicate this to developers better, so that you don't have to dig between tons unstructured docs / API references. And yes, we preferred to do this, rather than fixing an internal only (and marked as such already) API, which 3rd parties are not supposed to use.

Does that give you a bit better understand of what's going on? Also expect massive documentation updates over the next 1/2 months as all the 2015 surfaces and we approach the 5.1 enterprise release.

Hope this helps!
</blockquote>

topic Possible bug while checking in via REST API? in Alfresco Archive

Possible bug while checking in via REST API?

Re: Possible bug while checking in via REST API?