Version 1 of the distribution API started as a small proof-of-concept written in Go.Įssentially, it was a micro-service that glued together Keygen's licensing API and AWS S3, put onto its own domain. Mid last year, I happily released a redesign of our distribution API. Sometimes it may feel like you'll be stuck with your mistakes forever.īut it's not forever - there is a way to fix things.Ī way that doesn't require throwing everything out and retrying with a new API version.īut first, some context. I've been working on Keygen for over 6 years now, and I've made some design mistakes.įrom choosing bad names for things, to just poor API design.

Sure, you may have customers that use it ( they use everything after all!), but that doesn't mean it's ideal, or that it's even good. It also leaves you feeling like you have to absolutely nail an API's design the first time, even if you don't know what the perfect interface is yet. It leaves your API's design in a bad state, which sucks for developer morale, and it can leave your API interface a confusing mess, which sucks for customers. If you've ever been involved with designing and maintaining an API service, you probably know how both of these feel.īut I would argue that the latter is actually worse.Īt least you feel like you can fix the first one.įeeling like you can't undo past mistakes-frankly-sucks. Like feeling like you can't undo past mistakes in your API's design. There's almost nothing worse than accidentally making a breaking API change and not realizing it. Tl dr: We've open sourced a new gem called request_migrations for versioning REST APIs, inspired by Stripe's API versioning system. compare_arrows Build vs Buy Businesses of all sizes face the question of whether to build or buy.terminal Developer CLI NEW Use Keygen's official CLI to sign and publish software releases.phonelink_lock License Activation Portal Demo.Payments, and Postmark for transactional emails. bolt No-code Licensing Automation Use Zapier to integrate Keygen with your favorite tools, such as Stripe for.cloud_download Software Artifact Distribution Use Keygen's supplementary software distribution API to securely deliver artifactsĪnd offer automatic updates to licensed users.

lock_open Software Application Licensing Use Keygen's flagship software licensing API to add license key validation, deviceĪctivation and entitlements to any software product.

M objects keygen