apidays LIVE Helsinki & North - Providing API a childcare service by Nicola Pietroluongo, AWS1. © 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