Collection of best practices for creating SDKs for REST APIs
sdks.io
sdks.io
Happy to answer any questions!
We started this project at APIMatic to share our learnings about building and generating SDKs with the API community. We have helped dozens of API providers generate and deploy SDKs now used by millions of developers, giving us some confidence in the learnings we share in this resource.
Next, yes, it is hard to create and maintain production-ready SDKs for a large web API. There are so many open-source Code Generators for OpenAPI that aim to address this, but we found that they often do not follow the best practices for the languages they were generating SDKs for or did not create resilient SDKs. We cover both practices for ensuring a good developer experience for SDK users as well as methods for creating SDKs that help users to production-ready integrations faster.
Finally, while we are building a tool that we think solves the SDK problem for most API providers while following the best practices, we are still interested in creating a resource for folks who want to write their SDKs by hand, a kind of resource we ourselves wanted when we first started designing SDKs. We hope that this resource will be a time saver for those starting their API program today.