Absolutely! You can fully automate importing a Swagger/OpenAPI spec into a Postman collection without touching the Postman GUI—even set up auto-updates when your API changes. Here's a practical, Windows-focused guide to make this happen:

We’ll rely on official Postman tools to ensure reliability and compatibility:

• openapi-to-postman-cli: Converts Swagger/OpenAPI specs directly to valid Postman collection JSON.
• Postman CLI: Lets you interact with Postman (import collections, manage workspaces) entirely via command line.

Install them first:

• For openapi-to-postman-cli, you’ll need Node.js installed. Run this in PowerShell:

  npm install -g openapi-to-postman-cli
  

• For Postman CLI, use Winget (Windows Package Manager) for quick installation:

  winget install Postman.PostmanCLI
  

Create a PowerShell script (e.g., Update-PostmanCollection.ps1) with these steps. It’ll download your latest Swagger spec, convert it, and import it to Postman automatically:

# Configuration - Update these values to match your setup
$swaggerUrl = "https://myapi/v1/swagger.json"
$postmanWorkspaceName = "Your API Workspace"
$tempSwaggerFile = "swagger-latest.json"
$postmanCollectionFile = "postman-collection.json"

try {
    # 1. Download the latest Swagger spec
    Write-Host "Downloading latest Swagger spec from $swaggerUrl..."
    Invoke-WebRequest -Uri $swaggerUrl -OutFile $tempSwaggerFile -ErrorAction Stop

    # 2. Convert Swagger to Postman collection
    Write-Host "Converting Swagger to Postman collection..."
    openapi2postmanv2 -s $tempSwaggerFile -o $postmanCollectionFile -p -ErrorAction Stop

    # 3. Authenticate with Postman (run this once manually first, then keep it commented)
    # pm login --api-key $env:POSTMAN_API_KEY

    # 4. Import the collection to your workspace
    Write-Host "Importing collection to Postman workspace: $postmanWorkspaceName..."
    pm collections import $postmanCollectionFile --workspace $postmanWorkspaceName -ErrorAction Stop

    Write-Host "Success! Postman collection updated with latest API specs."
}
catch {
    Write-Error "Automation failed: $_"
    exit 1
}
finally {
    # Clean up temporary files
    if (Test-Path $tempSwaggerFile) { Remove-Item $tempSwaggerFile }
    if (Test-Path $postmanCollectionFile) { Remove-Item $postmanCollectionFile }
}

Critical Setup Notes: #

• Postman API Key: Grab yours from your Postman account settings (Profile > API Keys). Store it as a Windows user environment variable named POSTMAN_API_KEY (run [Environment]::SetEnvironmentVariable('POSTMAN_API_KEY', 'your-key-here', 'User') in PowerShell) to avoid hardcoding sensitive data.
• Workspace Name: Find your workspace name at the top of the Postman app—this ensures the collection goes to the right place.

To keep Postman in sync automatically when your API updates, pick one of these methods:

Option 1: Windows Task Scheduler (Periodic Checks) #

1. Open Task Scheduler > Create Task.
2. Under Triggers, set a schedule (e.g., every hour, or daily at 9 AM) to check for updates.
3. Under Actions, select "Start a program" and configure:
   • Program/script: powershell.exe
   • Add arguments: -ExecutionPolicy Bypass -File "C:\Path\To\Your\Update-PostmanCollection.ps1"
4. Under Settings, enable "Run whether user is logged on or not" for background execution.

Option 2: Trigger on Spec Changes (Version Control) #

If your Swagger spec is stored in Git (e.g., GitHub), set up a GitHub Actions workflow that runs whenever the spec file is updated. The workflow can execute the same PowerShell script (or a cross-platform equivalent) to push the updated collection to Postman instantly.

• Enhance error handling: Add checks for failed downloads or conversion issues (the script above includes basic try/catch, but you can expand it for your use case).
• Handle authenticated Swagger endpoints: If your Swagger URL requires auth, add headers to the Invoke-WebRequest command (e.g., -Headers @{"Authorization" = "Bearer $env:API_AUTH_TOKEN"}).
• Track versions: Use Postman’s built-in collection versioning to keep a history of API changes.

内容的提问来源于stack exchange，提问作者Guy