Documentation is wrong: POST to spring data rest collection endpoint [DATAREST-975]

[spring-projects-issues]

Robert Rackl opened DATAREST-975 and commented

GIVEN a child repository that references a parent repository
AND both repositories are exposed as HATEOAS rest services.
AND the parent repository already contains some rows.

WHEN you know want to ADD another child that references this existing parent,

THEN you send a POST request to the URI, e.g

POST http://localhost:8080/api/parent/1/children

The documentation sais you should send a header application/json. But it does not specifiy the JSON format what to send.

WORKAROUND: You can send a Content-Type: "text/uri-list" and only send the URI of the child you want to add.

curl -X POST -H "Content-Type: text/uri-list" -H "Cache-Control: no-cache" -d 'http://localhost:8090/liquido/v2/users/2' "http://localhost:8090/liquido/v2/ideas/1/supporters"

Suggestion: Update the documentation and specify exaxtly what to send

---

Reference URL: http://docs.spring.io/spring-data/rest/docs/current/reference/html/#_supported_http_methods

[spring-projects-issues]

Robert Rackl commented

See also this Stack Overflow question:
http://stackoverflow.com/questions/30555964/spring-data-rest-post-to-collection-end-point

[spring-projects-issues]

Oliver Drotbohm commented

You seem to mix up two types of resources. You point to the docs for collection resources but then show usage of association resources. The latter is clearly documented to expect text/uri-list

[spring-projects-issues]

Robert Rackl commented

Hh, sorry, I missed that spring data rest distinguished between "normal" collections and associations. Thank you for your reply