API Designer Confirmé F/H Recruteur partenaire

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 œuvre, 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 cœur de leurs systèmes d'information.
Nous concevons et mettons en œuvre 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.