Natuurlijk! Hier zijn enkele geavanceerde API testscenario's en configuraties in Postman voor het valideren van verschillende API-versies, inclusief compatibiliteit, regressie en verschillen: 1. Versiebeheer via Environment Variables Gebruik een environment variabele voor de versie, bijvoorbeeld `api_version`, en stel deze per omgeving of testscenario in. Voorbeeld: - `api_version` = `v1` of `v2` URL voorbeeld: ``` {{base_url}}/{{api_version}}/endpoint ``` 2. Versie-specifieke headers en parameters Stel in je request headers of parameters afhankelijk van de versie: - Bijvoorbeeld een `X-API-Version` header: ```json { "X-API-Version": "{{api_version}}" } ``` Of als query parameter: ``` ?version={{api_version}} ``` 3. Automatiseren van versie-switching via Pre-request Script Gebruik een script om automatisch te switchen tussen versies en test scenarios te genereren: ```javascript // Bijvoorbeeld, cycles door versies const versies = ['v1', 'v2']; let index = pm.environment.get('versie_index') || 0; pm.environment.set('api_version', versies[index]); index = (index + 1) % versies.length; pm.environment.set('versie_index', index); ``` 4. Versie-vergelijkingen en regressiecontroles Gebruik testscripts om de respons te valideren op basis van de versie: ```javascript // Controleer key-velden afhankelijk van versie if (pm.environment.get('api_version') === 'v1') { pm.test('V1 response structuur', () => { const jsonData = pm.response.json(); pm.expect(jsonData).to.have.property('veld_van_v1'); // andere asserts }); } else if (pm.environment.get('api_version') === 'v2') { pm.test('V2 response structuur', () => { const jsonData = pm.response.json(); pm.expect(jsonData).to.have.property('veld_van_v2'); // andere asserts }); } ``` 5. Versie-Comparatie Rapportages Maak een collection runner die alle versies test en sla de resultaten op. Gebruik bijvoorbeeld de Collection Runner met data files voor verschillende versies en vergelijk de outputs. 6. Testscenario's voor compatibiliteit - Test met oudere client headers: stuur request met headers van oudere versies en controleer of de API nog correct reageert. - Test met nieuwe features uit nieuwe versies en valideer dat oudere versies deze niet ondersteunen (backward compatibility). 7. Geautomatiseerde regressietests - Plaats verwachte responses in een data file en voer vergelijkingen uit tussen huidige responses en verwachte outputs per versie. **Voorbeeld van een volledige configuratie:** - Environment variables: - `base_url`: `https://api.mijnbedrijf.com` - `api_version`: `v1` (voor test) - `versie_index`: 0 (voor cycling) - Pre-request Script: ```javascript const versies = ['v1', 'v2']; let index = pm.environment.get('versie_index') || 0; pm.environment.set('api_version', versies[index]); index = (index + 1) % versies.length; pm.environment.set('versie_index', index); ``` - URL: ``` {{base_url}}/{{api_version}}/endpoint ``` - Headers: ```json { "X-API-Version": "{{api_version}}" } ``` - Tests: ```javascript const jsonData = pm.response.json(); if (pm.environment.get('api_version') === 'v1') { pm.test('V1: Status code', () => { pm.response.to.have.status(200); }); pm.test('V1: Response bevat veld_van_v1', () => { pm.expect(jsonData).to.have.property('veld_van_v1'); }); } else { pm.test('V2: Status code', () => { pm.response.to.have.status(200); }); pm.test('V2: Response bevat veld_van_v2', () => { pm.expect(jsonData).to.have.property('veld_van_v2'); }); } ``` Met deze aanpak kun je efficiënt verschillende API-versies testen en vergelijken, regressies detecteren en compatibiliteit controleren binnen Postman.

Hier is een uitgebreide handleiding voor het ontwerpen van geavanceerde API testscenario's in Postman voor API versievalidatie: ## 1. Postman Environment Configuratie Maak een environment aan met de volgende variabelen: ```json { "base_url": "https://api.mijnbedrijf.com", "current_version": "v2", "previous_version": "v1", "api_key": "jouw_api_sleutel", "auth_token": "bearer_token" } ``` ## 2. Versie-specifieke Request Headers Gebruik Pre-request Scripts om automatisch versieheaders toe te voegen: ```javascript // Pre-request Script voor versiebeheer const version = pm.environment.get("current_version"); pm.request.headers.upsert({ key: "API-Version", value: version }); // Optioneel: Content Negotiation header pm.request.headers.upsert({ key: "Accept", value: `application/vnd.mijnbedrijf.${version}+json` }); ``` ## 3. Geavanceerde Test Collectie Structuur ### Collection: "API Version Compatibility Tests" **Folder: v1 vs v2 Comparison Tests** **Request: GET Gebruikerslijst - Versie Vergelijking** ``` {{base_url}}/users ``` **Test Script:** ```javascript // Versie compatibiliteit test pm.test("Status code is 200", function () { pm.response.to.have.status(200); }); // Valideer response structuur voor beide versies const response = pm.response.json(); if (pm.request.headers.get("API-Version") === "v1") { pm.test("v1 response heeft verplichte velden", function () { pm.expect(response).to.have.property("gebruikers"); pm.expect(response.gebruikers[0]).to.have.property("naam"); pm.expect(response.gebruikers[0]).to.have.property("email"); }); } else if (pm.request.headers.get("API-Version") === "v2") { pm.test("v2 response heeft nieuwe velden", function () { pm.expect(response).to.have.property("data"); pm.expect(response.data[0]).to.have.property("volledigeNaam"); pm.expect(response.data[0]).to.have.property("contactEmail"); pm.expect(response.data[0]).to.have.property("gebruikerId"); }); } // Cross-version compatibiliteit check pm.test("Response bevat geen deprecated velden", function () { const deprecatedFields = ["oudVeld", "verouderdAttribuut"]; deprecatedFields.forEach(field => { pm.expect(JSON.stringify(response)).to.not.include(field); }); }); ``` ## 4. Regression Test Suite **Request: POST Nieuw Product** ``` {{base_url}}/products ``` **Body (raw JSON):** ```json { "naam": "Test Product", "prijs": 99.99, "categorie": "elektronica" } ``` **Test Script voor Regressie:** ```javascript // Regression tests voor kritieke functionaliteit pm.test("Product succesvol aangemaakt", function () { pm.response.to.have.status(201); }); const response = pm.response.json(); // Valideer dat kernfunctionaliteit intact blijft pm.test("Basis product velden aanwezig", function () { pm.expect(response).to.have.property("id"); pm.expect(response).to.have.property("naam"); pm.expect(response).to.have.property("prijs"); }); // Performance regression test pm.test("Response tijd acceptabel", function () { pm.expect(pm.response.responseTime).to.be.below(1000); }); // Backup response voor latere vergelijking pm.environment.set("last_product_response", JSON.stringify(response)); ``` ## 5. Version Migration Tests **Request: GET Gebruiker Details** ``` {{base_url}}/users/{{user_id}} ``` **Test Script:** ```javascript // Test voor backward compatibility pm.test("Backward compatibility behouden", function () { if (pm.request.headers.get("API-Version") === "v2") { const response = pm.response.json(); // Valideer dat v1 clients nog steeds werken pm.expect(response).to.have.property("email"); // v1 veld pm.expect(response).to.have.property("contactEmail"); // v2 veld // Valideer dat nieuwe velden correct werken if (response.heeftAbonnement) { pm.expect(response).to.have.property("abonnementsType"); } } }); ``` ## 6. Geavanceerde Collection Runner Scripts **Collection-level Test Script:** ```javascript // Globale version compatibility tests const versions = ["v1", "v2"]; versions.forEach(version => { pm.collectionVariables.set("current_version", version); // Test alle endpoints voor deze versie console.log(`Testing version: ${version}`); }); ``` ## 7. Dynamic Parameter Testing **Request: GET Producten met Version-specific Parameters** ``` {{base_url}}/products?categorie=elektronica&sorteer=naam ``` **Pre-request Script:** ```javascript // Voeg version-specific parameters toe const version = pm.environment.get("current_version"); const request = pm.request; if (version === "v2") { request.url.addQueryParams([ { key: "include", value: "voorraad,inventaris" }, { key: "velden", value: "naam,prijs,categorie,voorraad" } ]); } ``` ## 8. Automated Version Switching **Folder: Cross-Version Tests** **Pre-request Script:** ```javascript // Wissel automatisch tussen versies voor comparison const testRun = pm.info.iteration; const versions = ["v1", "v2"]; const currentVersion = versions[testRun % versions.length]; pm.environment.set("current_version", currentVersion); pm.request.headers.upsert({ key: "API-Version", value: currentVersion }); ``` ## 9. Response Validation en Diff Testing **Test Script:** ```javascript // Vergelijk responses tussen versies if (pm.environment.get("current_version") === "v2") { const v2Response = pm.response.json(); const v1Response = JSON.parse(pm.environment.get("v1_response_cache")); pm.test("v2 bevat alle v1 functionaliteit", function () { // Valideer dat v2 alle v1 velden ondersteunt Object.keys(v1Response).forEach(key => { if (key !== "deprecatedField") { pm.expect(v2Response).to.have.property(key); } }); }); } // Cache response voor latere vergelijking pm.environment.set(`${pm.environment.get("current_version")}_response_cache`, JSON.stringify(pm.response.json())); ``` ## 10. Monitoring en Reporting **Test Script:** ```javascript // Genereer compatibility report pm.test("Version compatibility report", function () { const version = pm.environment.get("current_version"); const testResults = { version: version, timestamp: new Date().toISOString(), endpoint: pm.request.url.toString(), status: pm.response.code, responseTime: pm.response.responseTime, testResults: {} }; // Log resultaten voor externe monitoring console.log(JSON.stringify(testResults)); // Post naar monitoring service (optioneel) pm.sendRequest({ url: 'https://monitoring.mijnbedrijf.com/api/test-results', method: 'POST', header: { 'Content-Type': 'application/json' }, body: { mode: 'raw', raw: JSON.stringify(testResults) } }); }); ``` ## Gebruikstips: 1. **Run collections** met verschillende environment variabelen 2. **Gebruik de Collection Runner** voor batch testing 3. **Implementeer monitors** voor automatische regression detection 4. **Sla responses op** voor historische vergelijking 5. **Gebruik Postman monitors** voor continue validatie Deze aanpak zorgt voor robuuste version compatibility testing en helpt regressies vroegtijdig te detecteren!