Automated API documentation and exploration using Apiary or Apigee

Hi,

We are looking at using Drupal 8 as a central data hub and data management portal / crm-type system, and then exposing that data for consumption and modification via RESTful web services. As the API would form a very core part of our system its essential that it is robust, comprehensive, and well documented. I'm interested to know wether any work has been done on integrating tools like Apiary or Apigee with Drupal 8 based web services.

We used Drupal 7 with the Services module quite heavily for a previous project and it was a bit of a train wreck. The API generated from Drupal 7 Services was a disaster - not a proper REST API, but more like a way of exposing web forms so that they could be submitted using json. There was no resemblance of good API design and just a lot of exposed drupalisms.

I'm still exploring Drupal 8 services but from what I have seen so far it's in a much better place that should enable full(?) REST based entity manipulation using a cohesive API. If my understanding and assumptions are correct and given that Drupal 8 will indeed provide full REST support for entities I would think it would be possible to generate proper API documentation, sandboxes, and exploration tools using tools like Apiary or Apigee, automatically directly from Drupal's data model.

Has anyone looked into this? Are there any existing tools that integrate with Drupal 8 (or Drupal 7 that could be potted to D8) that provide proper API documentation and exploration tools?

I'd also be interested to hear from people that have looked at or used the new web services in Drupal 8 and wether or not they feel that provide a full and standards based REST implementation.