Postman Collection¶
API Testing with Postman¶
We provide a comprehensive Postman collection to help you test our API endpoints easily.
Download Collection¶
You can download our Postman collection from the following location: - Postman Collection
Import Instructions¶
- Download the collection file
- Open Postman
- Click "Import" in the top left
- Drag and drop the collection file or click "Upload Files"
- The collection will be imported with all endpoints and examples
Environment Variables¶
To use the collection effectively, set up these environment variables:
Variable | Description | Example |
---|---|---|
base_url |
Your API base URL | https://api.example.com |
api_key |
Your API key | sk_test_1234567890 |
access_token |
OAuth access token | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... |
Setting Up Environment¶
- In Postman, click the "Environments" tab
- Click "New" to create a new environment
- Add the variables listed above
- Save the environment
- Select your environment from the dropdown in the top right
Collection Structure¶
Our Postman collection is organized into the following folders:
Authentication¶
- Login
- Refresh Token
- Logout
Shipments¶
- List Shipments
- Create Shipment
- Get Shipment
- Update Shipment
- Delete Shipment
Users¶
- List Users
- Create User
- Get User
- Update User
- Delete User
Pre-request Scripts¶
Some requests include pre-request scripts that automatically: - Set authentication headers - Generate timestamps - Format request bodies
Tests¶
Each request includes tests that: - Verify response status codes - Validate response schemas - Extract values for use in subsequent requests
Running the Collection¶
- Import the collection and environment
- Set up your environment variables
- Run the collection using the "Run" button
- Review the test results in the collection runner
Troubleshooting¶
If you encounter issues:
- Authentication Errors: Verify your API key and access token
- Rate Limiting: Check our rate limits
- Network Issues: Ensure your base URL is correct
- Schema Validation: Update the collection if our API has changed
Support¶
For help with the Postman collection: - Check our FAQ - Review our API documentation - Contact support
Last update:
July 14, 2025
Created: July 14, 2025
Created: July 14, 2025