search

devicehive / devicehive-java-server

DeviceHive Java Server
http://www.devicehive.com
Apache License 2.0
368 stars 138 forks source link

API Documentation #25

Open henrikbjorn opened 9 years ago

henrikbjorn commented 9 years ago

There does not seem to be a repository for the documentation found on devicehive.com/restful. So ill ask here.

How is it managed? if one wanted to propose changes or discuss some of the stuff?

We have found it to be incomplete, especially the methods for inserting and deleting individual equipments from a deviceclass.

astaff commented 9 years ago

Henrik, that's a very good point and I agree the documentation is far from being perfect. Good news is that there is a 2.0 beta coming out very soon and we'll update the documentation. In the meantime, if you have any questions, please post it here.

P.S. moving forward, we are also thinking of hosting documentation in github's markdown.

henrikbjorn commented 9 years ago

Is there a roadmap of planned changes for the 2.0beta?

astaff commented 9 years ago

Server side has been reworked significantly. Cassandra for notifications and commands storage, Kafka message bus, so you can have your own event processing on Spark Streaming. Automated deployment using Juju. Major changes are being made to gateway agent as well. Stay tuned! On Apr 25, 2015 1:24 PM, "Henrik Bjørnskov" notifications@github.com wrote:

Is there a roadmap of planned changes for the 2.0beta?

— Reply to this email directly or view it on GitHub https://github.com/devicehive/devicehive-java/issues/25#issuecomment-96241060 .

henrikbjorn commented 9 years ago

Don't really care about the implementation, just the spec :)

astaff commented 9 years ago

Stay tuned. On Apr 26, 2015 9:50 AM, "Henrik Bjørnskov" notifications@github.com wrote:

Don't really care about the implementation, just the spec :)

— Reply to this email directly or view it on GitHub https://github.com/devicehive/devicehive-java/issues/25#issuecomment-96381395 .

henrikbjorn commented 9 years ago

Okay. The reason i am asking is that we have our own implementation of the Specification, and would like to follow its development.

astaff commented 9 years ago

The new server API will be backwards compatible with the old one. We would appreciate if you could share your implementation. On Apr 27, 2015 5:50 AM, "Henrik Bjørnskov" notifications@github.com wrote:

Okay. The reason i am asking is that we have our own implementation of the Specification, and would like to follow its development.

— Reply to this email directly or view it on GitHub https://github.com/devicehive/devicehive-java/issues/25#issuecomment-96587437 .

henrikbjorn commented 9 years ago

Not possible in its current state, but hopefully we will be able to do this in the near future.