is-05
is-05 copied to clipboard
Deprecate /single PATCH Interface
By allowing for incomplete Requests to be made via HTTP Patch using the /single
Interface a more or less undocumented state-machine is created.
Apart from that request validation and general data handling becomes much simpler and convenient if implementations can expect complete requests. With less small pitfalls and potential mismatches between implementations interoperability should ultimately be improved as well.
In practice i have yet to see a controller that patches incomplete data to a sender or receiver.
In contrast i've seen many default to only using the /bulk
interface in combination with polling of the respective /active resources. Nodes of course don't have this luxury since they have to implement both.
/bulk
pretty much handles everything /single
does so why not deprecate it simplifying and narrowing down the API in the process.
This is something for a v1.2 of course.