You can’t drive as fast as you want any time you want, you can’t just park anywhere you want to and you can’t drive on whatever side of the road you want to drive on. If you follow some guidelines when driving, why not when designing and documenting APIs? You might think everyone could simply get up and do whatever they want to during the API design phase. But instead of working in a friendly-peaceful-full-of-rainbow-unicorns environment you would be in one without rules that would be chaotic.
The talk will share our experience running and contributing to the API Governance defined at Amadeus: the motivation behind it, the benefits of having an internal governance, what kind of activities we do, the roles and responsibilities of the members and -why not- sharing the existing pain points we have detected.