website logo
WildlinkWildfire-corpFeaturesNetworkCompanyPricingResourcesContact us
⌘K
Wildfire Systems Knowledgebase
Partner Admin
Commission History
Performance Summary
Desktop Solutions
Browser Extension Authentication
Implementing Wildfire Coupons into an existing Chrome Extension
How to Implement OAuth in a Chrome Extension
Direct tracking code injection to extension
Mobile Solutions
Android MCA SDK Guide
Android MCA Permission Compliance
How to implement the Mobile Safari Extension
Wildfire APIs
Country filtering and multiple applications
Public Commission Sample Data
Getting to know the Wildfire JSON Data Feeds
Creating links
Commission History
Gift Card
Merchants and Domains
Merchant Images
Tracking Code (TC) Parameter
Syncing Commission Data via API and Callbacks
Working with Wildfire Coupon Data
Getting started with the Wildfire API Postman collection
FAQ and General Resources
Jump Track
Best Practices
6 Reasons Why a User Might Not Get Credit for Earning
FTC Compliance Overview
Stand-Down Policy Compliance
Docs powered by archbee 
6min

Getting started with the Wildfire API Postman collection

Wildfire Systems maintains a Postman collection that makes exploring the REST APIs easy. In particular, the Postman collection includes a pre-request script that makes generating the auth headers automatic.



Getting the Postman collection

You can download/access the Postman collection via one of the following links, depending on your preference:

  • Postman web client
  • Postman desktop app

You can also download the desktop Postman client if you don't yet have it.

Once you have the collection open, you'll notice two folders contained within it: Client Endpoints and Admin Endpoints. With Wildfire, applications have specific endpoints that they're allowed to access depending on whether the application is a Client or an Admin. Client applications represent a Chrome Extension, a Mobile Safari Extension or a similar client software. Admin applications represent a system or server that you'll use to fetch all commissions for all client applications.

Creating a Wildfire device

Both Client and Admin applications must create a device using Wildfire's API before doing any other operation. Creating a device is the first part of our authentication flow. You'll notice that inside Client Endpoints -> Device that there's a Create Device call. Similarly, the Admin Endpoints > Device also has a Create Device call. These are the same call, but the difference between the two is the app ID and secret you use to invoke the call. Every Wildfire partner has at least one Client app ID and secret and one Admin app ID and secret. Be sure that you're using the right credentials for the right use case. If you're developing a system to fetch all the commissions for your account (across all clients that have been created) then you'll want to be sure to use the Admin app ID and secret.

Once you're sure you've got the right credentials, you'll want to create a new Postman Environment. Environments are how Postman keeps credentials and other volatile/sensitive values separate from the collection endpoints, documatation, etc. Your new Environment will have just two keys in it: app_id and app_secret . Once those are set, be sure to save the Environment and then select it as your active Environment. Now you'll be able to create a device and call the rest of the endpoints. The pre-request script takes the app_id and app_secret and generates all the necessary headers each time a call is made.

Next steps

Once you're done exploring the APIs with Postman, you can examine the pre-request script, which is mostly JavaScript, to get a sense for how to build these auth headers on your own (i.e. if you're working on a server-based solution).

Updated 03 Mar 2023
Did this page help you?
Yes
No
UP NEXT
Jump Track
Docs powered by archbee 
TABLE OF CONTENTS
Getting the Postman collection
Creating a Wildfire device
Next steps