zalando / restful-api-guidelines

A model set of guidelines for RESTful APIs and Events, created by Zalando
https://opensource.zalando.com/restful-api-guidelines/
Creative Commons Attribution 4.0 International
2.61k stars 384 forks source link

Make rule 111 consistent to 109 #765

Closed ePaul closed 6 months ago

ePaul commented 1 year ago

This sentence (and the following one) should be changed to match the approach in rule 109 (and also link to it).

pablosaraiva commented 8 months ago
  • Guideline 109 describes a conservative approach to API design – servers are supposed to reject unknown properties in inputs.
  • Guideline 111 says that "servers may reject requests whose entities contain undefined fields".

This sentence (and the following one) should be changed to match the approach in rule 109 (and also link to it).

Both links point to guideline 109.

Here is suggested edit to the issue:

Guideline 111

ktsypkina commented 7 months ago

raised a PR with suggested changes, please have a look! https://github.com/zalando/restful-api-guidelines/pull/793