> a self-discoverable REST API
I’ve been writing web services for over a decade and this just seems like a cute idea that is actually almost never at all useful in the real world.
I’ve been writing web services for over a decade and this just seems like a cute idea that is actually almost never at all useful in the real world.
Turns out, a lot of places don't even want self-discovery. We shut off our openapi.json in prod because a) security b) we don't want bots messing around c) Hyrum's law, as soon as you expose an API endpoint, folks try to build against it and grumble if it chances/goes away.
Wikipedia (along with any true wiki) is, and likely forever will be, the one true REST/HATEOAS application.