Descriptif du poste:\n\nEn 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. \nVous 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. \nResponsabilités \n* \nPrendre en charge des sujets API de bout en bout, depuis l'analyse du besoin jusqu'à la mise en production et l'évolution \n* \nAnalyser les enjeux métiers et les traduire en spécifications techniques d'API claires et exploitables \n* \nConcevoir des APIs REST et/ou GraphQL alignées avec des cas d'usage réels \n* \nS'assurer de la bonne application des bonnes pratiques API, notamment sur : \n* \nstructuration des ressources, \n* \ncohérence des modèles, \n* \nusage des verbes et statuts HTTP, \n* \ngestion des erreurs, \n* \nversioning et compatibilité \n* \nÊtre garant(e) de la qualité globale des APIs : \n* \nfonctionnelle, \n* \ntechnique, \n* \net d'usage en production \n* \nRédiger, maintenir et faire évoluer les spécifications d'API (OpenAPI / Swagger) sur l'ensemble du cycle de vie \n* \nTester et valider les APIs pour s'assurer de leur conformité aux spécifications et aux usages attendus \n* \nAccompagner les équipes de développement lors de l'implémentation et de l'intégration \n* \nPrendre en compte les sujets transverses : sécurité, performance, maintenabilité \n* \nChallenger les demandes lorsque nécessaire et proposer des solutions adaptées aux objectifs business \n* \nContribuer à l'amélioration continue des pratiques API au sein des équipes \n\nProfil recherché:\n\nPosture \n* \nExpérience confirmée (3 ans minimum) sur des projets où l'API constitue un livrable central \n* \nCapacité à intervenir sur des APIs existantes, en tenant compte des contraintes d'usage, de compatibilité et d'évolution \n* \nAptitude à partir d'un besoin métier parfois incomplet pour concevoir une API exploitable et pérenne \n* \nMaîtrise des arbitrages de design API (structuration des ressources, granularité, choix fonctionnels) \n* \nCapacité à challenger une demande lorsqu'elle n'est pas cohérente du point de vue API \n* \nApproche orientée usage, impact et valeur, au-delà de la simple conformité technique \n* \nPositionnement à l'interface entre équipes fonctionnelles et techniques \nCompétences techniques \n* \nConception et évolution d'APIs REST (GraphQL en complément) \n* \nRédaction et maintien de spécifications d'API servant de référence projet (OpenAPI / Swagger) \n* \nModélisation des contrats d'API (schémas JSON, payloads, paramètres, codes de retour, erreurs) \n* \nMise en œuvre, remise en question et amélioration continue des bonnes pratiques API \n(structure des ressources, verbes HTTP, gestion des erreurs, versioning, compatibilité) \n* \nMise en place de tests automatisés d'API, intégrés au cycle de développement \n(collections Postman ou Bruno exécutées via Newman ou équivalent, validation des comportements et du contrat) \n* \nContrôle de la qualité des spécifications et du design \n(linting OpenAPI avec Spectral, cohérence des contrats dans le temps) \n* \nTravail avec des outils d'API Management dans un contexte projet \n(exposition, sécurisation, politiques, documentation via IBM API Connect, Apigee, Kong, Gravitee ou équivalent) \n* \nIntégration des principes de security by design dans le design et l'évolution des APIs \n(OWASP API Security Top 10, OAuth2, JWT, exposition maîtrisée des données) \n* \nPrise en compte des enjeux de performance et de sobriété dès la conception \n(pagination, filtres, taille des payloads, limitation des appels inutiles) \n* \nUtilisation raisonnée d'outils IA pour assister le design, la revue et la cohérence des APIs \n(aide à la modélisation, revue de spécifications, détection d'incohérences) \n* \nIntervention sur plusieurs étapes du cycle de vie d'une API \n(besoin fonctionnel, spécification, implémentation accompagnée, tests automatisés, mise en production, évolutions)