Concept et outillage open source

1. C1 - Public Natixis
DESIGN & GOUVERNANCE API
Concept et outillage open source

2. C1 - Public Natixis
DANS TON API
#LE PITCH
Nous venons en aide à des entreprises dans leurs
besoins d’API
le chef Gusteau à la cuisine traditionnelle, passe la
main à son sous-chef (Skinner) avec l'objectif de se
moderniser.
Le sous-chef s'est mis au travail et après quelque
mois les dégâts sont arrivés (perte d’étoiles, baisse
de fréquentation,... )
Nous intervenons à ce moment-là de l'histoire
NOUVELLE EMISSION

3. C1 - Public Natixis
Romain « Ramsay » CABANE Aurélien « Etchebest » IANNI
#LesExperts
DANS TON API

4. C1 - Public Natixis
LE CONSTAT
#LheureDuDebrief
LE CONSTAT

5. C1 - Public Natixis
Ce que j’attends d’une API
• Documentation claire
• Contrat compréhensible
• Utilisation simple

6. C1 - Public Natixis
Ce que je trouve
• Documentation incompréhensible
• Contrat illisible
• Utilisation impossible

7. C1 - Public Natixis
Problème de compréhension de mon API
Client
Contrat
API

8. C1 - Public Natixis
Problème d’identité
• Identité pas claire
➢ Quels sont les services
proposés ?
• Pas de spécialisation = pas
d’expertise
• Perte de repère des clients
• Perte de business

9. C1 - Public Natixis
RESULTAT
• Utilisateurs perdus
• API non utilisée
• Peu ou pas de clients
• Peu ou pas de business
• Pas d’évolution possible

10. C1 - Public Natixis
PRESENTATION DE LA CIBLE
#LheureDesExplications

11. C1 - Public Natixis
LA GOUVERNANCE API
CHOIX DE L’IDENTITE
1. On part du constat/problématique
2. On fait l’étude (points forts/points faibles)
3. On choisit une approche/stratégie
en lien avec notre contexte/nos équipes
4. On choisit un type de gouvernance
5. On réalise les guidelines
6. On s’outille
7. On forme
8. On teste et on évalue
La méthodologie

12. C1 - Public Natixis
DESIGN FIRST
#Choix N°1 : l’approche

13. C1 - Public Natixis
Design first/spécification first = la recette
• On part d’une idée/d’une envie => le besoin
• On part d’un croquis de plat/pâtisserie
• On regarde les ingrédients que l’on va mettre dedans
• On élabore une recette
• On goutte, on corrige et on itère
• Un fois que c’est ok on l’envoie aux cuisiniers et on le met à la carte

14. C1 - Public Natixis
LA GOUVERNANCE
#CHOIX N°2 : la stratégie
• Style de gouvernance :
➢ Autoritaire/bloquante VS accompagnatrice/ démocratique
➢ Reproductible (pour d’autres équipes)
• Guidelines : simples, lisibles et cohérentes
• Outillage : aide au design – conception et test
➢Stoplight pour la conception
➢Spectral pour les tests

15. C1 - Public Natixis
LA FORMATION
#CHOIX N°3 : l’accompagnement
Les présentations
• Les APIs pour les nuls
• Les concepts généraux (de la conception à la sécurité)
Les formations
• Formation complète ouverte à tous
• Formation sur les outils
• Formation Gateway
• Formation sécurité

16. C1 - Public Natixis
LA FINALITE
Avoir un cycle de vie de l’API clair et
précis pour la production d’une API
➢ De la conception à la
réalisation, jusqu’à la mise
en prod et les évolutions
futures
➢ Archi sécu et gateway
= secure by design
S’évaluer, se tester, se confronter
➢ Guidelines sous Spectral
➢ REX métier
➢ REX clients

17. C1 - Public Natixis
LA MISE EN OEUVRE
#LheureDesActes

18. C1 - Public Natixis
CONCEPTION
ORIENTEE BESOIN(S)
Pose-moi ces
p** de couverts
et va en salle
Echanger avec les
consommateurs
Définir les objectifs
Déterminer le contexte
On écoute !!

19. C1 - Public Natixis
METHODOLOGIE(s) ? ®
Event Storming API Goal Canvas
The Design of Web APIs – Arnaud Lauret
Event Storming - Alberto Brandolini

20. C1 - Public Natixis
SOLUTION ORIENTEE
BESOIN(S)
Ce plat est d'une
tristesse... Même moi
en hiver, j’ai plus de
couleurs
Méthodologie
Guide de
conception
Et Spectral !

21. C1 - Public Natixis
DESIGN GUIDELINES &
OpenAPI CONTRACT

22. C1 - Public Natixis
Faciliter la vie
des designers
Automatiser la
vérification
Accélérer
l’adoption
Meilleure
intégration avec
les pratiques
SPECTRAL
au service de la conformité
Repose-toi bien,
et fais des vocalises
GitHub - BPCE

23. C1 - Public Natixis
STOPLIGHT STUDIO
AVEC SPECTRAL
Spectral Stoplight Studio

24. C1 - Public Natixis
OUI !
MAIS PAS A 100%
Si à chaque fois que je
te pose une question tu
te mets à pleurer, on va
pas s'en sortir !
Tout n’est pas
automatisable
Le concepteur doit
faire des choix

25. C1 - Public Natixis
LES CAS LIMITES
(Edge cases) Mince, j'ai dû le vexer...
Il a re-mal au bide
Alimenter le guide de
conception
Peuvent faire l’objet d’un
démonstrateur
Conforter les utilisateurs dans la
pratique

26. C1 - Public Natixis
Un guide de conception
multi-usage Alors moi j'm’y connais
en coup de pied au cul !
Fédérateur
Partager
Accessible
Evolutif
Simple
Rassurant

27. C1 - Public Natixis
ET ENFIN !!
Publication de la
solution
Validation
Client
Satisfaction
Client
Pourquoi vous ne le mettez pas dehors ?
Vous avez peur qu'il prenne froid le
menu ?

28. C1 - Public Natixis
ENSUITE ??
Je ne demande pas
pourquoi !
Incrémente
Affine
Vérifie

29. C1 - Public Natixis
LE BILAN
#LHeureDeLaddition

30. C1 - Public Natixis
6 mois plus tard …
Processus de
création
Intégration
continue
Sécurité du
déploiement
Focus sur les
nouveaux
besoins
Contrairement à ses
plats, la note, elle, va
être salée

31. C1 - Public Natixis
Une image retrouvée
Une clientèle de retour
Cycle de vie de nos APIs visibles
APIs plus claires, précises pour
nos clients
Une clientèle retrouvée, mais
aussi de nouveaux clients en vue
J'ai l'impression qu'on est dans une
taverne où je n'ai que des frères. Ils sont
tous chauves à barbe... C'est la famille !

32. C1 - Public Natixis
Décliner le
modèle
Nouvelles
méthodes
API
Developer
Portal
Marketplace
Un bel avenir en perspective

33. C1 - Public Natixis
Retrouvez nous sur notre
réseau
On attend vos feedbacks
Klaxoon
Sondage