Re: New Hydra API generator: feedback needed

Hi Kévin,

the wiki description of the collection design is at

http://www.w3.org/community/hydra/wiki/Collection_Design

The issues are #41 and #42.

Best regards,
Dietrich


On March 9, 2015 9:58:09 PM Kévin Dunglas <dunglas@gmail.com> wrote:

> Hi,
>
> I've published a new tool to create hypermedia REST API with the Symfony
> framework.
> It supports JSON-LD and Hydra and leverages Symfony to make it really easy
> to the average web developper to create that kind of API. Even if they
> don't share any code, this bundle has been inspirited by Markus's
> HydraBundle and can be considered as a HydraBundle on steroid.
>
> It uses Doctrine, Symfony Serializer (2.7) and Symfony Validator metadata
> to generate the Hydra documentation (no need for special annotations -
> except for external IRIs -, a typical Doctrine entity class will works
> great without any extra work) ; it supports out of the box serialization
> and deserialization groups, pagination, filters, errors and is highly
> extensible (event system, pluggabbles normalizers).
> The code source and the full list of features is available on GitHub:
> https://github.com/dunglas/DunglasJsonLdApiBundle
>
> I've also built a demo API (a bookstore). The source code is also available
> on GitHub: https://github.com/dunglas/api-platform
> A public endpoint is available here: http://bookstore-api.dunglas.fr
> HydraConsole:
> http://www.markus-lanthaler.com/hydra/console/?url=http://bookstore-api.dunglas.fr
>
> It works great with the Hydra console. However, there is two features not
> well described in the generated Hydra documentation and I don't know how to
> handle that correctly:
>
>    - Filters (ex: http://bookstore-api.dunglas.fr/organizations?name=another)
>    are not described in the Hydra documentation. I've read about hydra:search
>    in the spec but I don't know where is the preferred way to add those
>    definitions. In hydra:supportedOperation? Do you have an example of an API
>    using hydra:search available?
>    - Many-To-Many relations such as the author property in this document:
>    http://bookstore-api.dunglas.fr/books/2 An hydra documentation is
>    generated but should be invalid because the collection of is not recognized
>    by Hydra console. Any hint on how to fix that?
>
> Any feedback, both on the JSON-LD / Hydra support and on the ease of use as
> a web developer is welcome.
>
> P.S.: I've read on the list about a new Collection format but wasn't able
> to find the mail or the issue where it is described, can you send me a
> pointer to this new format?
>
> Best regards,
>
>
> --
> Kévin Dunglas
>
> http://dunglas.fr