Naarmate de API evolueert, ontstaan nieuwe methoden, parameters en logica. Om het werk van huidige klanten niet te verstoren, wordt API versioning gebruikt. We ondersteunen verschillende benaderingen van versioning, waardoor integrators de gewenste versie van de interface kunnen gebruiken zonder risico voor stabiele werking.
Dit is belangrijk zowel bij het schalen van het platform als bij het implementeren van updates, testen of het onderhouden van oude klanten.
Versioneringsmethoden
| Werkwijze | Beschrijving en voordelen |
|---|---|
| Versie in URL ('/v1/') | De meest begrijpelijke en populaire manier is handig voor de REST API |
| Header accepteren | Voorbeeld: 'Accept: application/vnd. api + json; versie = 2 '- scheidt gegevens van versie |
| GrafiekQL alias/versioneerde velden | Verschillende versies via aliassen: 'userV 1', 'userV 2' - handig voor geleidelijke migratie |
| Schema-niveau-versies | Afzonderlijke diagrammen en modules in OpenAPI/Swagger voor elke versie |
Hoe geïmplementeerd
API-structuur met '/v1/', '/v2/' en onafhankelijke routes
Koppen 'Accepteren' en 'X-API-versie' controleren
GrafiekQL ondersteunt aliassen en versierde schema's ('userV 1', 'userV 2')
Vermogen om A/B nieuwe versies te testen zonder risico voor de productie
Aanmelden van oproepen naar elke versie voor analyse en migratie
Zakelijke en integratorvoordelen
Steun oude klanten zonder vertraging
Multi-generatie API parallelle operatie
Veilig nieuwe functies implementeren zonder achterwaartse compatibiliteit te breken
Flexibiliteit op schaal en verbetering van de infrastructuur
Naadloze migratie tussen gecontroleerde en analytische versies
Waar vooral belangrijk
Platforms met meerdere externe clients
Projecten met API-eerste aanpak en lange levenscyclus
Integratie met banken, aanbieders, B 2B-partners
Systemen met langlevende mobiele of IoT-klanten
API versioning is de basis van betrouwbaarheid en flexibiliteit in integraties. Ongeacht het formaat (REST, GraphQL of gRPC), we zorgen voor de veilige ontwikkeling van interfaces - zonder storingen, conflicten en verlies van compatibiliteit.