1.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
1
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
Nicola Pietroluongo - AWS Senior Solutions Architect
Providing a childcare service for your API
Best practice for API design that scale

2.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
2
The brain

3.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
3
The brain

4.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
4
The brain

5.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
5
The growth

6.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
6
What are you talking about?

7.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
7
Evolution
The initial design process is critical.
API must continue to provide
strategic value in the future.

8.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
8
Evolution
It’s your mindset that needs to change

9.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
9
Evolution
Versatile
Optimised
Long-living
Verbose
Easy to consume
Not affected by new functionalities
Capable to adapt
Operate at or above user expectations
Deliver Long-term value
Enhanced visibility (logging, monitoring, errors, …)
Standards, documented, easy integration
Extensible

10.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
10
Where to start?

11.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
11
Customer Obsession
Customer requirement
Project requirement
Project requirement

12.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
12
Example
{
“name”: “MasterToaster 3000”,
”totalPrice“: “€ 24”,
}
{
“itemName”: “MasterToaster 3000”,
”itemPrice“:{
“currencyCode”: ”EUR”,
“amount”: 20.00,
},
”itemTax“:{
“currencyCode”: ”EUR”,
“amount”: 2.00,
}
}
A Product API for your e-commerce in Helsinki

13.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
13
Define a strategy
Market
D
Market
A
Market
B
Market
C
basic value proposition
Evo 2
Evo X
Horizontal strategy
Evo DX
Evo D2
Vertical strategy

14.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
14
Example
MasterToaster 3000
Price: 25 €
Colours:
The perfect Xmas gift
MasterToaster 3000
Price: 40 €
Colours:
The perfect Xmas gift

15.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
15
Example
Product Product
Variant
Stage 1
MasterToaster 3000
Price: 25 €
Colours:
The perfect Xmas gift
Price: 40 €
Price: 40 €
MasterToaster 3000
Price: 25 €
Colours:
The perfect Xmas gift
Product Product
Variant
Stage AX
Stage A1 Stage B1
Stage X

16.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
16
How to choose what’s right?

17.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
17
Listen, Learn, Build, Measure

18.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
18
© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
Listen

19.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
19
© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
Learn

20.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
20
© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
Build

21.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
21
© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
Measure

22.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
22
© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
Specific Measurable Achievable Relevant Time bound KPI

23.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
23
The basics measures
API Application Metrics
• RPM (Requests per Minute)
• Average and Max Latency
• Errors Per Minute
API Product Metrics
• Usage Growth
• Unique Consumers
• Top Consumers by Usage or Revenue
• Retention Rate
• Time to First Hello World (TTFHW)
• API Calls per Business Transaction
• Version adoption

24.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
24
Setup a framework
New
opportunities
Customers
Experience
Listen Learn
Build
Measure
Adoptions

25.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
25
Fail Fast
Fail Fast
Time
Cost per failure
Cost
of
errors
Number of errors

26.
© 2021, Amazon Web Services, Inc. or its Affiliates. All rights reserved. Amazon Confidential and Trademark
26
Succeed early!
Thank you!
@niklongstone