Migration IBM API Connect → Kong Konnect
Ce guide vous accompagne dans la migration de vos intégrations depuis l'ancien portail IBM API Connect vers le nouveau portail Kong Konnect.
Résumé des changements
| Élément | IBM API Connect | Kong Konnect |
|---|---|---|
| URL de base | https://api.stef.com/ | https://api.stef.com/ |
| Authentification | Client ID / Secret IBM | OAuth 2.0 / API Key Kong |
| Gateway | DataPower | Kong Gateway |
| Portail | Drupal (connect_theme) | Kong Dev Portal v3 (MDC) |
| Spécifications | Swagger 2.0 | OpenAPI 3.0 |
| Rate limiting | Plan-based | Plugin-based (configurable) |
Étape 1 : Nouveaux identifiants
Vos identifiants IBM API Connect existants continuent de fonctionner pour les abonnements déjà en place.
En revanche, pour toute nouvelle souscription à une API, vous devez :
- Créer un compte sur le nouveau portail (si pas encore fait)
- Créer une nouvelle application
- S'abonner aux APIs souhaitées
- Récupérer vos nouveaux credentials (API Key)
Étape 2 : Gestion des erreurs
Le format des erreurs a changé :
Ancien format IBM
{
"httpCode": "404",
"httpMessage": "Not Found",
"moreInformation": "Resource not found"
}
Nouveau format Kong
{
"status": 404,
"title": "Not Found",
"detail": "The requested resource was not found",
"instance": "/v1/transport/orders/invalid-id"
}
Checklist de migration
- Créer un nouveau compte sur le portail Kong
- Créer une application et récupérer les credentials
- Adapter le parsing des erreurs au nouveau format
Support migration
Besoin d'aide pour migrer ?
Notre équipe de support reste à votre disposition pour vous accompagner dans votre migration. N'hésitez pas à nous contacter.