Hier is een gestructureerde aanpak om een aangepaste Postman API-testworkflow te maken die meerdere omgevingen ondersteunt en automatisch omgevingsspecifieke logica toepast: 1. Omgevingsconfiguratie instellen: - Maak voor elke omgeving (Ontwikkeling, Test, Productie) een aparte omgeving in Postman. - Voeg in elke omgeving de variabelen toe: - `API_SLEUTEL` - `BASIS_URL` - Voorbeeld: - Ontwikkeling: `API_SLEUTEL = dev-sleutel`, `BASIS_URL = https://dev.api.example.com` - Test: `API_SLEUTEL = test-sleutel`, `BASIS_URL = https://test.api.example.com` - Productie: `API_SLEUTEL = prod-sleutel`, `BASIS_URL = https://api.example.com` 2. Automatisering van omgevingswissel: - Gebruik Postman's Collection Runner of een script (bijvoorbeeld via Newman) om automatisch de gewenste omgeving te selecteren op basis van een vooraf ingestelde parameter of via commandline argumenten. - Bijvoorbeeld, je kunt een omgevingsvariabele `CURRENT_ENV` gebruiken om te bepalen welke omgeving actief is. 3. Variabelen efficiënt beheren: - Gebruik de environment variabelen `API_SLEUTEL` en `BASIS_URL` in je API-verzoeken via `{{API_SLEUTEL}}` en `{{BASIS_URL}}`. - Dit zorgt dat je dezelfde collectie kunt gebruiken voor alle omgevingen door simpelweg de omgeving te wisselen. 4. Testworkflow opzetten met voorwaardelijke logica: - Voeg in je testscripts in Postman (bijvoorbeeld in de "Tests" tab) een controle toe op de huidige omgeving en voer alleen bepaalde tests uit in productie. - Voorbeeld script in JavaScript: ```javascript // Controleren op omgeving const environmentName = pm.environment.name; if (environmentName === "Productie") { // Voer betalingstests uit pm.test("Betaling succesvol", function () { pm.response.to.have.status(200); // aanvullende checks voor betaling }); } else { // Skip betalingstests of voer alternatieve tests uit pm.test("Betalingstests overgeslagen in niet-productie omgeving", function () { pm.expect(true).to.be.true; }); } ``` 5. Geautomatiseerde workflow: - Maak een hoofdcollectie waarin je alle API-eindpunten test. - Voor de betaling gerelateerde tests, gebruik de bovenstaande voorwaardelijke logica. - Gebruik environment variabelen en eventueel pre-request scripts om bijvoorbeeld tokens of API-sleutels dynamisch op te halen indien nodig. 6. Test uitvoeren: - Gebruik Newman voor commandline automatisering: ```bash newman run jouw-collectie.json -e jouw-omgeving.json --env-var "CURRENT_ENV=productie" ``` - Of stel de omgeving handmatig in via Postman UI voordat je de collectie runt. Door deze aanpak automatiseer je het wisselen van omgevingen, beheer je variabelen efficiënt en pas je de testuitvoering aan op basis van de omgeving. Hierdoor wordt je testworkflow flexibel, herbruikbaar en makkelijk te onderhouden.

Hier is een stapsgewijze handleiding voor het opzetten van een aangepaste Postman API-testworkflow met omgevingsondersteuning: ## 1. Omgevingsconfiguratie Maak drie omgevingsbestanden in Postman: **Ontwikkeling (Development)** ```json { "id": "development", "name": "Ontwikkeling", "values": [ { "key": "BASIS_URL", "value": "https://dev.api.jouwbedrijf.nl", "type": "default" }, { "key": "API_SLEUTEL", "value": "dev_12345_secret", "type": "secret" }, { "key": "OMGEVING", "value": "development", "type": "default" } ] } ``` **Test** ```json { "id": "test", "name": "Test", "values": [ { "key": "BASIS_URL", "value": "https://test.api.jouwbedrijf.nl", "type": "default" }, { "key": "API_SLEUTEL", "value": "test_67890_secret", "type": "secret" }, { "key": "OMGEVING", "value": "test", "type": "default" } ] } ``` **Productie (Production)** ```json { "id": "production", "name": "Productie", "values": [ { "key": "BASIS_URL", "value": "https://api.jouwbedrijf.nl", "type": "default" }, { "key": "API_SLEUTEL", "value": "prod_abcde_secret", "type": "secret" }, { "key": "OMGEVING", "value": "production", "type": "default" } ] } ``` ## 2. Collection Structuur Organiseer je requests in deze structuur: ``` 📁 API Collection ├── 📁 Gebruikersbeheer │ ├── GET /gebruikers │ ├── POST /gebruikers │ └── GET /gebruikers/{id} ├── 📁 Bestellingen │ ├── GET /bestellingen │ ├── POST /bestellingen │ └── GET /bestellingen/{id} ├── 📁 Producten │ ├── GET /producten │ ├── POST /producten │ └── GET /producten/{id} └── 📁 Betalingen (Alleen Productie) ├── POST /betalingen └── GET /betalingen/{id} ``` ## 3. Pre-request Script (Voor elke request) ```javascript // Stel basis URL en authenticatie in pm.request.headers.upsert({ key: 'Authorization', value: 'Bearer ' + pm.environment.get('API_SLEUTEL') }); // Update request URL met basis URL const baseUrl = pm.environment.get('BASIS_URL'); const originalUrl = pm.request.url.toString(); if (!originalUrl.includes(baseUrl)) { const path = pm.request.url.getPath(); pm.request.url = baseUrl + path; } ``` ## 4. Collection-level Tests ```javascript // Algemene response validatie pm.test("Status code is 200", function () { pm.response.to.have.status(200); }); pm.test("Response tijd is acceptabel", function () { pm.expect(pm.response.responseTime).to.be.below(1000); }); // Omgevingsspecifieke logging console.log("Huidige omgeving: " + pm.environment.get("OMGEVING")); console.log("Basis URL: " + pm.environment.get("BASIS_URL")); ``` ## 5. Voorwaardelijke Test Logica **In betalingstests (Collection-level):** ```javascript // Alleen uitvoeren in productie-omgeving const huidigeOmgeving = pm.environment.get("OMGEVING"); if (huidigeOmgeving === "production") { // Betalingstests uitvoeren pm.test("Betaling endpoint beschikbaar", function () { // Test logica hier }); } else { console.log("Betalingstests overgeslagen - niet in productie omgeving"); pm.test.skip = true; // Tests overslaan } ``` **Alternatief: Folder-level script voor betalingen** ```javascript // Pre-request script voor betalingsfolder const omgeving = pm.environment.get("OMGEVING"); if (omgeving !== "production") { console.log(`Betalingstest overgeslagen in ${omgeving} omgeving`); postman.setNextRequest(null); // Stop de uitvoering } ``` ## 6. Automatisering met Collection Runner Maak een test script voor automatische omgeving switching: ```javascript // Collection runner script const environments = ['development', 'test', 'production']; let currentEnvIndex = 0; function runTestsForEnvironment(environmentName) { console.log(`Tests uitvoeren voor: ${environmentName}`); // Stel omgeving in postman.setEnvironmentVariable("OMGEVING", environmentName); // Voer collection uit // Postman zal automatisch de juiste omgeving selecteren } // Itereer door omgevingen environments.forEach(env => { runTestsForEnvironment(env); }); ``` ## 7. Geavanceerde Workflow Script ```javascript // Workflow management script const workflowConfig = { development: { runPaymentTests: false, timeout: 5000, logLevel: 'debug' }, test: { runPaymentTests: false, timeout: 10000, logLevel: 'info' }, production: { runPaymentTests: true, timeout: 15000, logLevel: 'error' } }; // Dynamische test configuratie const currentEnv = pm.environment.get("OMGEVING"); const config = workflowConfig[currentEnv]; // Pas timeouts aan op basis van omgeving pm.environment.set("REQUEST_TIMEOUT", config.timeout); // Conditionele test uitvoering if (config.runPaymentTests) { console.log("Betalingstests worden uitgevoerd"); } else { console.log("Betalingstests overgeslagen"); } ``` ## 8. Gebruikstips 1. **Snel omgeving wisselen**: Gebruik Postman's omgeving selector 2. **Variabelen beheren**: Gebruik de Environment manager voor centrale configuratie 3. **Automation**: Gebruik Newman (Postman CLI) voor CI/CD pipelines 4. **Monitoring**: Log omgevingsinformatie in test resultaten ## 9. Newman CLI Commando (voor automatisering) ```bash # Test alle omgevingen sequentieel newman run collection.json -e development.json newman run collection.json -e test.json newman run collection.json -e production.json # Of met een script npm run test:all-environments ``` Deze workflow biedt flexibele omgeving-ondersteuning, efficiënt variabelebeheer en intelligente testuitvoering op basis van omgevingsspecifieke voorwaarden.