Api Designer Confirmé H/F - So-Api Consulting

En tant qu'API Designer chez So-API Consulting, vous participez à la conception d'APIs performantes et sécurisées, adaptées aux besoins fonctionnels des projets clients.
Vous intervenez sur des APIs conçues pour être concrètement utilisées en production, y compris dans des contextes intégrant de l'IA ou des traitements automatisés.

Responsabilités

- Prendre en charge des sujets API de bout en bout, depuis l'analyse du besoin jusqu'à la mise en production et l'évolution

- Analyser les enjeux métiers et les traduire en spécifications techniques d'API claires et exploitables

- Concevoir des APIs REST et/ou GraphQL alignées avec des cas d'usage réels

- S'assurer de la bonne application des bonnes pratiques API, notamment sur :

- structuration des ressources,

- cohérence des modèles,

- usage des verbes et statuts HTTP,

- gestion des erreurs,

- versioning et compatibilité

- Être garant(e) de la qualité globale des APIs :

- fonctionnelle,

- technique,

- et d'usage en production

- Rédiger, maintenir et faire évoluer les spécifications d'API (OpenAPI / Swagger) sur l'ensemble du cycle de vie

- Tester et valider les APIs pour s'assurer de leur conformité aux spécifications et aux usages attendus

- Accompagner les équipes de développement lors de l'implémentation et de l'intégration

- Prendre en compte les sujets transverses : sécurité, performance, maintenabilité

- Challenger les demandes lorsque nécessaire et proposer des solutions adaptées aux objectifs business

- Contribuer à l'amélioration continue des pratiques API au sein des équipes

Posture

- Expérience confirmée (3 ans minimum) sur des projets où l'API constitue un livrable central

- Capacité à intervenir sur des APIs existantes, en tenant compte des contraintes d'usage, de compatibilité et d'évolution

- Aptitude à partir d'un besoin métier parfois incomplet pour concevoir une API exploitable et pérenne

- Maîtrise des arbitrages de design API (structuration des ressources, granularité, choix fonctionnels)

- Capacité à challenger une demande lorsqu'elle n'est pas cohérente du point de vue API

- Approche orientée usage, impact et valeur, au-delà de la simple conformité technique

- Positionnement à l'interface entre équipes fonctionnelles et techniques

Compétences techniques

- Conception et évolution d'APIs REST (GraphQL en complément)

- Rédaction et maintien de spécifications d'API servant de référence projet (OpenAPI / Swagger)

- Modélisation des contrats d'API (schémas JSON, payloads, paramètres, codes de retour, erreurs)

- Mise en oeuvre, remise en question et amélioration continue des bonnes pratiques API
(structure des ressources, verbes HTTP, gestion des erreurs, versioning, compatibilité)

- Mise en place de tests automatisés d'API, intégrés au cycle de développement
(collections Postman ou Bruno exécutées via Newman ou équivalent, validation des comportements et du contrat)

- Contrôle de la qualité des spécifications et du design
(linting OpenAPI avec Spectral, cohérence des contrats dans le temps)

- Travail avec des outils d'API Management dans un contexte projet
(exposition, sécurisation, politiques, documentation via IBM API Connect, Apigee, Kong, Gravitee ou équivalent)

- Intégration des principes de security by design dans le design et l'évolution des APIs
(OWASP API Security Top 10, OAuth2, JWT, exposition maîtrisée des données)

- Prise en compte des enjeux de performance et de sobriété dès la conception
(pagination, filtres, taille des payloads, limitation des appels inutiles)

- Utilisation raisonnée d'outils IA pour assister le design, la revue et la cohérence des APIs
(aide à la modélisation, revue de spécifications, détection d'incohérences)

- Intervention sur plusieurs étapes du cycle de vie d'une API
(besoin fonctionnel, spécification, implémentation accompagnée, tests automatisés, mise en production, évolutions)

So-API Consulting est une ESN dédiée à l'accompagnement des entreprises dans leur transformation numérique en plaçant les APIs au coeur de leurs systèmes d'information.
Nous concevons et mettons en oeuvre des APIs qui répondent à des cas d'usage métiers réels, utilisées par des applications, des partenaires et, de plus en plus, par des solutions d'IA et d'automatisation.