Processus d'intégration
Chaque intégration API YAPU suit un processus de livraison structuré en trois phases. Cette page explique chaque phase, les responsabilités de chacun et ce à quoi s'attendre à chaque étape.
Vue d'ensemble du processus
Spécification → Développement → Tests → Système prêt
(1–3 sem.) (2–8 sem.) (1–2 sem.)
Les calendriers sont approximatifs. La durée du développement dépend des priorités logicielles internes de YAPU et de la rapidité de développement de votre équipe.
Phase 1 — Spécification
Durée : 1 à 3 semaines après la signature du contrat
La phase de spécification établit une compréhension technique commune avant tout développement. Les deux parties doivent s'accorder sur la conception de l'intégration avant d'avancer.
Étapes
| Étape | Pilotée par | Description |
|---|---|---|
| 1. Appel de cadrage | Les deux | Un appel commun pour identifier vos besoins en API REST et vos objectifs d'intégration |
| 2. Création du cas d'usage | YAPU | YAPU crée le cas d'usage API et le diagramme de flux de données / utilisateur |
| 3. Validation du cas d'usage | Les deux | Les deux parties examinent et s'accordent sur le cas d'usage et le flux |
| 4. Spécification des données | Guidé par YAPU | YAPU guide le client dans la spécification des données exactes à transférer |
| 5. Documentation technique | YAPU | YAPU crée la documentation technique complète de l'API |
| 6. Validation de la documentation | Les deux | Les deux parties examinent et approuvent la documentation technique |
Livrables
- Cas d'usage et diagramme de flux validés
- Documentation technique API finalisée
- Champs et formats de données confirmés dans les deux sens
Préparez votre équipe d'intégration pour l'appel de cadrage. Plus vous décrivez clairement votre flux opérationnel et ce que votre système doit faire, plus la phase de spécification avance rapidement.
Phase 2 — Développement
Durée : 2 à 8 semaines après la fin de la spécification
YAPU et le client développent chacun leur côté de l'intégration en parallèle, à partir de la documentation technique convenue.
Développement YAPU
L'équipe d'ingénierie de YAPU implémente les endpoints API et la logique d'intégration côté plateforme YAPU.
Développement client
Votre équipe de développement implémente l'intégration côté système — effectuant des requêtes vers l'API YAPU et traitant les réponses conformément à la spécification convenue.
Alignement
Si des questions ou des divergences surviennent pendant le développement, des appels d'alignement sont organisés entre YAPU et l'équipe cliente pour les résoudre avant les tests.
:::warning Note sur le calendrier de développement La fourchette de 2 à 8 semaines reflète la variabilité de la file de priorités logicielles internes de YAPU et la rapidité de développement côté client. Votre contact YAPU vous tiendra informé du planning de développement YAPU. :::
Phase 3 — Tests
Durée : 1 à 2 semaines après la finalisation du développement des deux côtés
Les tests confirment que l'intégration fonctionne de bout en bout avant la mise en production.
Étapes de test
| Étape | Environnement | Description |
|---|---|---|
| 1. Tests internes | Système propre à chaque partie | Chaque côté teste son implémentation de manière indépendante |
| 2. Tests d'intégration mutuels | Staging | Les deux parties testent l'intégration complète ensemble dans l'environnement de staging |
| 3. Déploiement en production | Production | Les deux côtés déploient leur intégration en production |
| 4. Tests d'intégration mutuels | Production | Les deux parties testent l'intégration complète en production pour confirmer la mise en production |
Une fois les tests de production confirmés par les deux parties, le système est prêt à l'utilisation.
Récapitulatif des responsabilités
| Responsabilité | YAPU | Client |
|---|---|---|
| Créer le cas d'usage et le diagramme de flux | ✓ | |
| Guider la spécification des données | ✓ | |
| Créer la documentation technique API | ✓ | |
| Développer l'API côté YAPU | ✓ | |
| Développer l'intégration côté client | ✓ | |
| Tests internes du développement propre | ✓ | ✓ |
| Tests d'intégration mutuels en staging | ✓ | ✓ |
| Déploiement en production | ✓ | ✓ |
| Tests d'intégration mutuels en production | ✓ | ✓ |
Estimation du calendrier total
| Phase | Durée estimée |
|---|---|
| Spécification | 1–3 semaines |
| Développement | 2–8 semaines |
| Tests | 1–2 semaines |
| Total | 4–13 semaines |
Après la mise en production
Une fois le système en production et les deux parties ayant confirmé que l'intégration fonctionne correctement, une période de stabilisation commence. Durant cette période, votre contact YAPU reste disponible pour soutenir tout problème découlant de l'utilisation en production.
Consultez Tests et mise en production pour plus de détails sur le processus de test et la liste de contrôle de mise en production.