Getting Organized for APIs in the Corporate Environment Sophie Rutard, Head of APIs at Euler Hermes

1. Strictly Confidential
Sophie Rutard
for API days Paris
on Dec 10th, 2019
GETTING ORGANIZED FOR
APIS IN THE CORPORATE
ENVIRONMENT
1

2. LEADING THE WORLD OF TRADE CREDIT INSURANCE
and part of Allianz today
>100 years

3. 3
Data +Money
TODAY, INSURANCE MEANS FINTECH.
+ Algorithms

4. 4
CREDIT INSURANCE IS AN ENABLER FOR GLOBAL TRADE
———
———
$!

5. 5
CURRENT API
>300
customers and
partners on legacy API
190B€
of our global exposure
managed via API
110Mn
API calls / year

6. 6
ORGANISATION #1
IT dev and
architecture teams
API consultancy
team

7. 7
ORGANISATION #2
IT dev and
architecture teams
API „design and
mgmt“ team
API consultancy
team

8. 8
BUT WE HAD TO STEP FURTHER!
SO
A
P
ESB
Ageing Monolith
systems
only 6 Releasesper year,
with system downtimes
Not scalable!
High support efforts
Radical change!!!

9. 9
A LOT OF REST API TO BE BUILT!
Risk mgmt
Policy
administration
Claims & Collections
handling
Finance
Payments
KYC Reference Data
Document
archive
e-Signature
CRM
…
>50
APIs
>450
Endpoints
< >

10. 10
API-CENTRIC MEANS EVERYBODY IS CONCERNED!

11. 11
CENTRALIZED ORGANIZATION

12. 12
Time for our new Organization!
:-)

13. 13
THANK YOU, SPOTIFY!
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
• Product vision
• Business Strategy
• Target user groups
• Quality of service
• Technical design
• Performance
• Sustainability
• Deployment
IT + Business
working as one
team!

14. 14
CHALLENGE #1/5 - CONSISTENT DESIGN
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps

15. 15
CHALLENGE #1/5 - CONSISTENT DESIGN
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API and Data
governance teams
ensure consistent
Design
Former
developer
completeIT beginner
self-
learner
• Maintain EH API design
guide and API catalogue
• Maintain EH Data model
• Coaching squad’s POs
• Contribute in design sprints
• Validate Swagger / merge
requests in Gitlab before dev
• Maintain documentation and
testing (Postman) guidelines

16. 16
CHALLENGE #2/5 - CLOUD-RELATED ASPECTS
• API Security
• CI/CD Pipeline
• AWS Expertise and
FinOPS
• Monitoring tools
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
API
Product
owner
API
Tech
lead
Scrum
master, BA;
devOps
Cloud Foundation
and IT security
teams ensure
consistent
implementation
‣ IDP (OAuth2)
‣ Ressource Manager
‣ API Gateway
‣ Cloudfront & AWS WAF

17. 17
CHALLENGE #3/5 - PLANNING AND ALIGNMENTS
Customer Portal API-based productsInternal applications Partner applications
API
Product
owner
API
Tech
lead
Scrum
master,
API
Product
owner
API
Tech
lead
Scrum
master,
API
Product
owner
API
Tech
lead
Scrum
master,
API
Product
owner
API
Tech
lead
Scrum
master,
API
Product
owner
API
Tech
lead
Scrum
master,
API
Product
owner
API
Tech
lead
Scrum
master,
API
Product
owner
API
Tech
lead
Scrum
master,

18. 18
• Big room only for highly
strategic projects with
massive interdependencies
(costly!)
Sprint 1 Sprint 2 Sprint 3 Sprint 4 Sprint 5 Sprint 6
API 1
Front
API 2
API 3
API 4
API 5
Infra
Comm
Scrum of scrum and big
room plannings are
essential for strategic
alignment and planning.
CHALLENGE #3/5 - PLANNING AND ALIGNMENTS

19. 19
CHALLENGE #4/5 - TESTING

20. 20
ADVANTAGES OF ALIGNED TESTING
Multiple reusages:
• Auto NR tests in CI/CD Pipeline
• API Sandbox
• Collections are part of techn.
documentation
1 Collection
per API

21. 21
CHALLENGE #5/5 - DOCUMENTATION
PhotosbyMarilyTorres,rawpixel.comandHiteshChoudharyfromPexels
API Documentation is for Developers AND Business analysts.
And for decision makers.
The wording must be adapted to each usergroup.

22. 22
EH
API Squads
External and
EH internal
API Consumers
EH
API Consumer
advisory
• Swagger
• API sandbox
• Postman collections
• SDK
• Release notes
2nd level support
Technical Writing /
functional documentation
PO / Squad DevPortal
fdsva
Self Service
and Feedback
SHARING IS CARING.
„Made by developers, for developers“

23. 23
APIS SUCCESSFULLY CONNECT SYSTEMS…
But first, you need to connect the people!

24. THANK YOU!