APIDays Paris - APIOps Cycles - Open and lean method for API Development

@mniinioja @apiopscycles
APIOps®
Cycles
open set of tools and
methods for lean API
development
@mniinioja
@apiopscycles
@digiaonline
https://www.linkedin.com/in
/marjukkaniinioja/
CC-BY-SA

Global API locations In the scarce world
of API research,
this provides
important view on
APIs, from global
economy point of
view.
Hmm… how
can we change
this?
@miinioja @apiopscycles

Source: Huhtamäki & al. Visualizing the Geography of Platform Boundary Resources: The Case of the Global API Ecosystem
Amount of APIs correlates
with Global Startup Index and
economic growth areas.
APIs thrive in cultures where
user-centered design is
dominant.
Mashups combining several
APIs require certain amount
of co-location and mindset for
marketers and developers to
co-create.

POST /add
POST /del
Hand-written
documentation
200 attributes for payload “just
because we have them”
Sensitive information in URI and
Query parameters
When we get new API users, we need to boot our servers
to give them access
“Basic auth is just fine”Not validating specfiles
So what is the PROBLEM?

• Worked at 3 companies + Finnish government
• Consulted, trained or advised 200 companies
on APIs, microservices, integrations and AI
• Helping companies grow their API teams 9x
• Guided 10+ API thesis workers
• Created 1 method for API development
Writing 1 book about API economy with
professor Marko Seppänen, APItalist Jarkko
Moilanen and Mika Finnish e-gov & internet
specialist Mika Honkanen

No matter how many API
evangelists, conferences &
blogs….
@kyyberi
https://www.linkedin.com/in/jarkkomoilanen/

The rogue API developer
doesn’t know there is...
A Good Way
✓ and a Bad Way
⛔
of creating APIs

We all come from
different villages &
we copy bad design
from existing APIs
Common sense
Bon sens
Maalaisjärki
+ copying existing APIs
In Finnish, aka “Village sense”

SKILLED humans +
Working TOGETHER
Good METHOD +
= GREAT APIs

Worked with people from
different disciplines
around APIs
💁🙎
CX, UX, Service designers, Marketing & Sales,
Procurement Legal, HR, Developers, Enterprise
Architects, Network & Security, Microservice
Architects, Integration Architects, Cloud Architects,
Information Architects

“Can you TEACH us about APIs”
“Can you tell us how to build a
great API-team”
“Can you help us build our
PLATFORM”
“Thank god you are here sorting us
out on how to design our
MICROSERVICES architecture”
Frequently Asked
QUESTIONS:
“I know APIs will change your
CULTURE and business
STRATEGY - and I’m here to help
you with that”
The API and microservices design
- yeah, I can do that, too, but it’s
the C & S you really need ...
my ANSWERS:
Which required a lot of
explanation…

I was a typical EXPERT. New how to do it, but not how to
teach others to do it. It felt like art, but there had to be
science. Also other than computer science. I just found
hardly any beyond the US and UK API industry presentations
I tapped in to my roots in EDUCATION (M. Ed.)
But I was missing an API-specific METHOD.
Method ?
Observation and
reflection
Observation and reflection
Observation and
reflection
Expert
Concrete Experience
MotivationSkills
Constructivist
view on learning

So I ended up creating
APIOps® Cycles method
And with the team & the method,
a consulting product, training and
an a concept called API
Hackatemia for
API Hackatemia is new type of service
for schools, companies and other
organisations. It combines co-creation
with customers, teachers, students
and employees using AI, chatbots and
the method to create new services.

I analyzed common practices for the
business, designers, architects and
developers compared to API
development

Business models and business model canvases were well known
by the business people and designers, so was Lean Startup

Everyone hates NFRs so why not make them as easy
and business user friendly as a coloring book - adults can
do them, too, it’s trendy and relaxing.

Using the Minimum Viable Architecture and making
an Minimum Viable API Architecture version of it
gave a lean and Agile boost to the architecture, too
Prototype
Just enough
Scale
API Audit -checklist collects all the rookie mistakes
usually done with designing APIs, even by otherwise
experienced developers. Like not validating your
schemas. Or putting sensitive info in the URI
parameters.
It’s great for improving the Developer Experience,
security, metrics and API mgmt adoption. And helps in
onboarding newbie API developers

https://api.posti.fi/index.html
https://stripe.com/fi
https://op-developer.fi/ https://developer.nordeaopenbanking.com
API UX for developers is different than UX for the person with the money.
CX for developers is not to scare them with the sales guy.
No 1 choice
by
developers
for first
impression
No 1 choice by product
managers, although the
APIs are loved by all.
Developers fear they
have to talk to sales.
”Looks like the
bank, don’t know
about the APIs”
”What is this? What
do I get? Do I need
to talk to sales?”

Customer Experience, UX and Developer Experience are in the method,
too – but it needs a bit more depth…
Fagerholm, F. and Münch, J., 2012, June. Developer experience: Concept
and definition. In Software and System Process (ICSSP), 2012
International Conference on (pp. 73-77). IEEE.

I ended up talking to lots of people
Everyone said “Great method”
- “but we need it to be OPEN” said customers
- “we have to do an API audit to all the APIs we do or meet,
OMG the results will be horrible but so USEFUL” said a
colleague at Digia Plc
- “we really see this method as giving the backbone to our
community, APIOps®” said Jarkko Moilanen and Chandra
Challagonda from APInf Ltd.
“Looks like we are
writing around the same
area, how to create
business value with
APIs” said Amanzio
Bouza of Swisscom

www.apiopscycles.com
Join the email list or
follow us on twitter @apiopscycles
Offline training is already ongoing and
on-line training and certifications are
coming 02/2018 by @osaangoltd and
@digiaonline
Please let us know if you use the
method or find something to improve.
The method is Creative Commons (CC-BY-SA). Let’s make some more
dots on the map – for a sustainable future and more equal growth

APIDays Paris - APIOps Cycles - Open and lean method for API Development

More Related Content

What's hot

Similar to APIDays Paris - APIOps Cycles - Open and lean method for API Development

Recently uploaded

APIDays Paris - APIOps Cycles - Open and lean method for API Development