Re: API Platform: a PHP API-first web framework relying on JSON-LD, Hydra and Schema.org

Hi Ruben,

Thank you for the positive feedback!

The API supports (if I've not missed) anything almost all the current Hydra
Core Vocabulary:

   - collections and pagination
   - errors
   - API Documentation (available at the /vocab URL of all APIs)

They are automatically generated and enabled by default (but it has been
designed to be disable-able, replaceable by other formats such as HAL if
necessary).

Hydra and JSON-LD matches what we need, here are some minor issues/comments:

   - I haven't managed to understand  how to document a different set of
   attributes for create and update operation (e.g. an attribute readable and
   writeable only in a POST but only readable in PUT). It's a little issue but
   can be annoying.
   - I haven't managed how to document filters (hydra:search) in the vocab
   instead of in the collection result (to decrease responses sizes). So they
   are documented in the collection return for now.
   - We extended the error format to return a json object containing a list
   for "property": "error description", it was more convenient for frontend /
   JavaScript developers (it should be perfectly valid to do that, but it
   would be nice to have a similar feature directly in the spec).

Even if it works well with Hydra Console, I'm still not sure that the
Hydra/JSON-LD implementation is perfect. Feedback and bug reports on that
topic are appreciated.

Best regards,



2015-06-13 14:08 GMT+02:00 Ruben Verborgh <ruben.verborgh@ugent.be>:

> Hi Kévin,
>
> Very good to see this stuff, this seems what developers need.
>
> I wonder if you could tell a little about the role the Hydra plays,
> and whether you experienced difficulties getting Hydra in.
> Was it a straightforward match, or did you have to bend some things?
>
> Best,
>
> Ruben
>



-- 
Kévin Dunglas
Consultant et développeur freelance

http://dunglas.fr
Tél. : 06 60 91 20 20