3 ms·
We gave up on structured APIs 20+ years ago when JSON RPC largely replaced XML REST. You can do REST in many different formats, it mainly just needs to be struc
by _heimdall 5mo ago
We gave up on structured APIs 20+ years ago when JSON RPC largely replaced XML REST. You can do REST in many different formats, it mainly just needs to be structured data and self-discoverable.
Had we not made that wrong turn, LLMs and humans would have a much easier time reasoning about APIs they don't directly control.
- ex-aws-dude 5mo agoYeah but why would we keep that around for 20 years with no good use case
- _heimdall 5mo agoWhy do you assume theres no good use case? trpc, grpc, etc are all attempts to add schemas back into JSON. Swagger, OpenAPI, etc are attempts to add discover ability back into JSON-based RPC APIs. MCPs fall in here as well, which attempt to add schemas and discover ability back in where our APIs aren't actually RESTful.
- zepolen 5mo ago> You can do REST in many different formats, it mainly just needs to be structured data and self-discoverable. REST has nothing to do with structured data or discoverability.
- _heimdall 5mo agoSchemaed data may be more accurate than structured. Regardless I'd be curious how you would consider something RESTful when it isn't schemaed data or discoverable via the data describing actions that can be taken.