Migreren vanaf Postman
1. Exporteren uit Postman
Section titled “1. Exporteren uit Postman”In Postman: Collection ▸ … ▸ Export ▸ Collection v2.1. Doe hetzelfde voor uw omgevingen.
2. Importeren in Restorm
Section titled “2. Importeren in Restorm”Bestand ▸ Importeren (Ctrl+I) en daarna het JSON-bestand. Restorm herkent
het formaat zelf.
Meer details: Een Postman-collectie importeren.
Wat automatisch meekomt
Section titled “Wat automatisch meekomt”| Postman | Restorm |
|---|---|
| Mappen | Mappen, op dezelfde diepte |
| HTTP-verzoeken | HTTP-verzoeken |
| GraphQL-verzoeken | GraphQL-verzoeken (geen HTTP-verzoeken) |
| Body’s van het type raw, formdata, urlencoded, file, graphql | Het overeenkomstige bodytype |
| Collectievariabelen | Variabelen van een omgeving |
| Beschrijvingen | Aantekeningen en API-documentatie |
| Voorbeeldresponsen | API-documentatie |
| Pre-requestscripts en tests | Een uitvoerbaar scenario, met de pm.*-laag |
Wat u moet bijstellen
Section titled “Wat u moet bijstellen”De authenticatie
Section titled “De authenticatie”De authenticatieblokken van Postman worden gedocumenteerd (met gevoelige waarden gemaskeerd) maar niet omgezet in uitvoerbare inloggegevens.
Maak een authenticatieverzoek aan: dat
kost u vijf minuten, en u krijgt er het automatisch vernieuwen van het token en
de nieuwe poging bij een 401 voor terug, wat Postman niet vanzelf doet.
De omgevingen
Section titled “De omgevingen”Exporteer ze uit Postman en maak ze opnieuw aan in een omgevingsmap.
Maak van de gelegenheid gebruik om subomgevingen te gebruiken: waar Postman één platte omgeving per doel oplegt, laat Restorm een gemeenschappelijke basis toe met overschrijvingen per klant of per regio.
De runners en Newman
Section titled “De runners en Newman”Dit is de meest lonende vervanging. Een scenario doet wat een runner doet, maar beter:
- de stroom is zichtbaar in plaats van een impliciete collectievolgorde;
- vertakkingen, lussen en nieuwe pogingen zijn vakjes, geen
pm.setNextRequest; - de uitvoering in CI is ingebouwd, met nette afsluitcodes — zie Headless uitvoering en CI.
Overeenkomsten tussen de concepten
Section titled “Overeenkomsten tussen de concepten”| Postman | Restorm |
|---|---|
| Workspace | Een project .restorm, in git in versiebeheer |
| Collection | Een map of een omgevingsmap |
| Environment | Een omgeving in een omgevingsmap |
| Globals | Een hoofdomgeving, waarvan de kinderen erven |
| Pre-request / Test script | Een scenario, of een code-actie |
| Collection Runner | Een scenario |
| Newman | restorm --run --headless |
| Mock Server | De servermodus, lokaal |
| Monitors | Een actie Timer, of een geplande taak in uw CI |
| Postman Console | De console |
Dynamische variabelen {{$random…}} | Dezelfde, plus 116 helpers — zie de referentie |
Het fundamentele verschil
Section titled “Het fundamentele verschil”Uw verzoeken worden bestanden in uw repository. Ze doorlopen dezelfde reviewcyclus als uw code, hun geschiedenis is de git-geschiedenis, en de toegangsrechten zijn die van uw forge.
Geen gehoste werkruimte om te beheren, en geen API-gegevens bij een dienst van
derden. Zie
Projecten en .restorm-bestanden.
En wat Postman heeft en Restorm niet
Section titled “En wat Postman heeft en Restorm niet”Om eerlijk te zijn: Restorm heeft geen gehoste samenwerkingsruimte, geen openbaar API-portaal, geen inline commentaar op verzoeken, en geen gehoste monitoring. Leunt uw organisatie op die zaken, dan is daar geen directe tegenhanger voor — delen gaat via git.