Comment by throwaway613745
Comment by throwaway613745 2 days ago
wut
we have a mixed graphql/REST api at $DAY_JOB and our delete mutations look almost identical to our REST DELETE endpoints.
TFA complains needing to define types (lol), but if you're doing REST endpoints you should be writing some kind of API specification for it (swagger?). So ultimately there isn't much of a difference. However, having your types directly on your schema is nicer than just bolting on a fragile openapi spec that will quickly become outdated when a dev forgets to update it when a parameter is added/removed/changed.
Generate the open API spec from the backend for internal applications.
No need to update manually. Further, you can prevent breaking changes to the spec using oasdiff