Ga naar inhoud

Een Postman-collectie importeren

Restorm importeert de collecties Postman v2.0 en v2.1 (het formaat dat “Export ▸ Collection v2.1” in Postman oplevert).

Bestand ▸ Importeren (Ctrl+I) en daarna het geëxporteerde .json-bestand.

De boom die de import van een Postman-collectie oplevert: een omgevingsmap in de wortel, één submap per Postman-map, en één verzoek per item met het bijbehorende werkwoord

Element uit PostmanWat Restorm daarmee doet
Mappen (geneste item)Mappen, op dezelfde diepte
VerzoekenHTTP-verzoeken — of GraphQL wanneer de body van het type graphql is
Body’s van het type raw, formdata, urlencoded, file, graphqlHet overeenkomstige bodytype
CollectievariabelenDe variabelen van een omgeving
BeschrijvingenDe aantekeningen van het verzoek en de API-documentatie
VoorbeeldresponsenDe API-documentatie

Dit is het deel dat deze import onderscheidt. Uw pre-request- en testscripts gaan niet verloren: ze blijven in de documentatie bewaard en worden omgezet naar een uitvoerbaar scenario waarvan de code-vakjes het script ongewijzigd uitvoeren.

Restorm biedt daarvoor een compatibiliteitslaag pm.* in zijn JavaScript-code-acties: pm.environment, pm.variables, pm.response, pm.test, pm.expect, pm.sendRequest, pm.setNextRequest, pm.cookies… Uw asserties blijven dus werken zonder herschrijven.

De authenticatieblokken van Postman (oauth2, apikey, bearer, basic, digest, hawk, aws, ntlm, edgegrid) worden gelezen en samengevat in de API-documentatie, met de gevoelige waarden gemaskeerd.

Ze worden niet omgezet in uitvoerbare inloggegevens: maak een authenticatieroute aan — dat kost vijf minuten, en u krijgt er het automatisch vernieuwen van het token voor terug.

Postman hoort bij de formaten die opnieuw te synchroniseren zijn (als de collectie vanaf een URL is geïmporteerd): de knop Vernieuwen van de map haalt de bron op en Restorm past het verschil toe. Zie Bijwerken vanaf de bron.

De gids Migreren vanaf Postman doorloopt de volledige migratie, inclusief de omgevingen en de runners.