3 ms·
It really depends on the language and framework you're using how convenient OpenAPI actually is to implement. In many cases there's a lot of additional manual e
by jrsj 3y ago
It really depends on the language and framework you're using how convenient OpenAPI actually is to implement. In many cases there's a lot of additional manual effort involved if you can't auto generate a schema, or at least generate one that is good enough to then generate client libs from.
- korm 3y agoI've been disappointed with almost every OpenAPI spec I've come across for this reason. They're OK for documentation but can't auto generate clients due to errors.
- BerislavLopac 3y agoThere are three standard models of working with API schemas, in relation to the implementation: * manual: * schema is maintained manually, independent of the implementation * usually an afterthought and used mainly for documentation * implementation-first: * schema is autogenerated from the code * used as a reference, possibly to generate clients, and often to run tests * probably the most common approach, supported by many frameworks * schema-first: * schema is maintained manually, with client and server code generated from it * very rare, but the most correct approach