apidays Helsinki & North 2025 - From Chaos to Clarity: Designing (AI-Ready) APIs with APIOps Cycles, Marjukka Niinioja (Osaango)

From Chaos to Clarity: Designing (AI-Ready) APIs with APIOps Cycles
Marjukka Niinioja, APItalista & Founding Partner at Osaango

apidays Helsinki & North 2025 - APIs for Innovation, Intelligence, and Impact
June 3 & 4, 2025

------

Check out our conferences at https://www.apidays.global/

Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8

Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io

Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/

Transcript

1. 1 Designing (AI-Ready) APIs with APIOps Cycles From Chaos to Clarity
2. Marjukka Niinioja Marjukka is the founder of Osaango Ltd, which offers API consulting and training, focusing in API Economy and API Lifecycle. Marjukka is a business and technical consultant, speaker at API conferences, co-author of the API Economy 101 book, and the “Mother” of the lean, open and business-oriented APIOps Cycles method. She has over ten years of experience with the API and data economy across manufacturing, process, forest, retail, energy, ICT, construction and traffic industries. She teaches API and data economy and has created open university online and remote courses. Osaango has been mentioned as one of the global top 20 API management companies https://www.marketdataforecast.com/ market-reports/api-management- market and we develop and train of openly licensed, Lean and business- oriented APIOps Cycles method https://www.apiopscycles.com We work as part of “The API Collective” collaborating to provide services to our clients around the world https://theapicollective.com/ Hi, nice to meet you! Contact me: Marjukka Niinioja marjukka.niinioja@osaango.com +358 40 838 7308 Connect with me on LinkedIn
3. 3 • LLMs are everywhere • Autonomous teams release APIs at warp speed • Multi-cloud = multiple platforms • Governance can’t keep up • Product thinking and business goals are distant from APIs The Chaos We Created
4. APIDays Paris 2024 Marjukka Niinioja, Osaango 4 Your APIs should be reusable, understandable, and aligned. You can’t fix strategy with Swagger
5. APIDays Paris 2024 Marjukka Niinioja, Osaango 5 A method to align strategy with execution. Think of it as a shared language and roadmap for making great APIs— whether you're a developer, architect, or product owner. • Metro map of API lifecycle • Core stations: with exit and entry criteria Product Strategy, Design, Consumer Experience...) • Metrolines guiding you to specific goals: Business, Platform, Delivery • Canvases and checklists to help collaboration and quality What is APIOps Cycles?
6. APIDays Paris 2024 Marjukka Niinioja, Osaango 6 Some examples of the impact we have helped to create with our customers A global financial transactions service provider and an Australian bank • enhanced there API strategies, • discovered new, actionable ideas, and • adopted our open-source, globally adopted APIOps Cycles method for continuous improvement. An European device management company accelerated its expansion in the US market, finding strategic integration solutions that propel growth. A US-based SaaS company elevated its API developer experience, aligning its strategic roadmap with innovative enhancements. The impact! It’s not just us, for example QriarLabs based in Brazil has even integrated the canvases in their API platform: https://qriarlabs.com/qap-canvas/
7. While different API consumers will have different consumer experience needs… 7 Human AI Needs docs Needs structured data Can ask Slack questions Only knows what you publish Flexible interpretation Hallucinates without clarity
8. … they are all intended to help with a ”human” journey, but even that can be presented in AI friendly way 8 Canvas Creator & Canvases now available in Finnish, German and Engish! https://canvascreator.apiopscycles.com/
9. 9 • Predictable naming • Rich OpenAPI specs • Explainable responses • Lifecycle status • Semantic versioning • Monitoring + traceability How to make your APIs AI-ready
10. API Journey for a Startup’s First API A startup launching its first external API— focus on the "Core Stations" to move fast and learn quickly. API Journey for Scaling the Enterpise An enterprise scaling APIs across business units—use the "API Platform Architecture" line to align governance and scalability. strategy into technology solutions. Create effective APIs and integrations and decide on development approaches. APIDays Paris 2024 Marjukka Niinioja, Osaango 10 API Journey for Legacy Redesign Possibly start on the "API Consumer Experience" to ensure relevance and usability, iterate “API Product Strategy” to just confirm the view on target state before moving forward towards the next core stations. Examples of traveling on the Metro Map according to your goals
11. APIDays Paris 2024 Marjukka Niinioja, Osaango 11 APIs are journeys, not destinations. Mapping your journey prevents getting lost. Start Small: Use the APIOps Cycles core stations as a foundation for your next API project. Collaborate: Share the map with your team and identify areas for improvement. Scale: Use APIOps Cycles to scale your API products across teams and ecosystems. Where do you want your API journey to go?
12. APIDays Paris 2024 Marjukka Niinioja, Osaango 12 Follow the method in LinkedIn to join the conversation
13. 1 Strategize: API-enable the Vision Align APIs and integrations with business goals and product strategy. 2 Build: Make the vision real Turn strategy into technology solutions. Create effective APIs and integrations and decide on development approaches. APIDays Paris 2024 Marjukka Niinioja, Osaango 13 3 Build for Scale: Enhance and Adapt Grow and adapt solutions for business success. Plan and execute platform scalability and modernization strategically. We’d love to help you map and improve your API journey with our partners! API Health Check Strategy, service model technology, roadmap API mgnt and Developer portal setup Partner onboarding journey design Optionally: Futudemy innovation and learning program Short-term and long-term support with APIOps Cycles workshops and intelligent architecture
14. APIDays Paris 2024 Marjukka Niinioja, Osaango 14 Contact me: Marjukka Niinioja marjukka.niinioja@osaango.com +358 40 838 7308 Connect with me on LinkedIn