News for hackers. Stuff that matters.

A comment on Problems with Swagger. Parent comment

Re:Problems with Swagger by richardwhiuk on Tuesday April 04, 2017 @04:38PM (#14036975)
I meant a user friendly client, not something aimed at API developers. Sure you can create something which is aimed at Developers, but it's not presenting the data in a way any user would understand, or in a way that a UX expert can flex.

Fundamentally, your display logic should not be linked to your API schema, but HATEOAS essentially enforces that, because you can't predict what links will be available.

[ Parent | on HN ]
Re:Problems with Swagger by icebraining on Tuesday April 04, 2017 @06:43PM (#14037947)
your display logic should not be linked to your API schema

Why not? The whole point of HATEOAS is to design your API schema in function of your application flow. You know, just like we do on websites.

[ Parent | on HN ]
Re:Problems with Swagger by lucideer on Wednesday April 05, 2017 @06:46AM (#14041123)
> I meant a user friendly client, not something aimed at API developers. Sure you can create something which is aimed at Developers

Just for clarity, are you talking about API Developers or API Client Developers? I would see the primary beneficiaries of HATEOAS being developers consuming your API - i.e. client developers.

[ Parent | on HN ]