API providers are faced with the tough choice whether to offer client libraries (SDKs) or just ask developers to integrate their API directly via HTTP requests. Both options have their advantages and disadvantages, and they cater to different developer preferences. Creators of developer portals must also consider different types of integration and organize their documentation appropriately. By looking at various examples from API providers, both positive and negative, we will try to understand how to create and document useful SDKs, but also how to design APIs for easy consumption without an associated client library, providing good developer experience for developers with different preferences.