Postman Collection
Test every Food Trace API endpoint instantly using our ready-made Postman collection.
What is Postman?
Postman is a free API testing tool that lets you send HTTP requests, inspect responses, and organise requests into collections — all without writing any code. It's the fastest way to explore and verify API behaviour before building your integration.
Download the Collection
Contains all endpoints — Users, Products, Newlines, and Suppliers — with pre-configured
variables for base_url and api_key.
api_key variable.
Replace it with your own key before sending any requests — see
Authentication for how to obtain one.
How to Import & Use
If you don't already have Postman, download the free desktop app from postman.com/downloads. It's available for Windows, macOS, and Linux. You can also use Postman Web directly in your browser without installing anything.
Click the Download Collection button above to save
FoodTrace_API.postman_collection.json to your computer.
- Open Postman.
- Click Import in the top-left corner (or press Ctrl + O / ⌘ + O).
-
Drag and drop the
.jsonfile onto the import window, or click Upload Files and browse to it. - Click Import. The Food-Trace Developer API collection will appear in your left sidebar.
The collection uses a {{api_key}} variable so you only need to set your key once.
- In the Collections sidebar, click the Food-Trace Developer API collection name.
- Select the Variables tab.
- Find the
api_keyrow and paste your key into the Current Value column. - Click Save (Ctrl/⌘ + S).
base_url variable if you're running the API locally
(default is http://localhost/developer/api/v1).
Change it to https://developer.traceallglobal.com/api/v1 for production.
- Expand the Food-Trace Developer API collection in the sidebar.
- Open a folder — for example Users — and click Get User.
- Update any path variables shown in the Params tab (e.g. set
user_idto a real ID). - Click Send.
- The JSON response will appear in the lower panel with the HTTP status code.
{
"success": true,
"data": {
"userid": 14,
"firstname": "John",
"lastname": "Doe",
...
}
}
What's Inside the Collection
Users
- POSTCreate User
- GETGet User
- PUTUpdate User
- DELETEDelete User
Products
- GETGet Product
- PUTUpdate Product
- GETGet Allergens
- GETGet Nutritional Info
Newlines
- GETGet Newline
- PUTUpdate Newline
- POSTCreate Newline
- DELETEDelete Newline
Suppliers
- POSTCreate Supplier
Tips & Troubleshooting
401 Unauthorized
Your api_key variable is empty or incorrect. Double-check the Variables tab on the collection and make sure Current Value is set.
Could not connect
Check that base_url is pointing at the correct server. For local development use http://localhost/developer/api/v1.
SSL certificate error
If you're testing locally with a self-signed certificate, go to Settings → General and turn off SSL certificate verification. Never disable this in production.
400 Missing required field
POST and PUT request bodies already include all required fields. Be sure to fill them in with real values — the placeholders in the collection are examples only.