Types of API Call
Bidlogix offers three types of API along with the follow calls:
- Item Management
- Call: Create Auction
- Call: Create Items
- Reference Data
- Call: Auction Data
- Call: Auctioneer Data
- Call: Category Data
- Call: Fetch Reference Data
- Call: Vendor Data
- Call: Auction Item Reports
- Call: Auction Reports
- Call: Category Reports
- Call: User Reports
Structure of API Calls
It is vital to structure API Calls properly to receive the correct information, retain security and minimise the chance or errors.
HTTP Header Info
For all API calls set the following headers:-
headers.set(X-Api-Password, <<client password>>);
All HTTP headers should be in lower case
API Signature in Header
All API calls must have the signature in the header, as described in this document: API Security - Generating your Signature.
Substitutions / Query String Parameters
The following query string parameter applies to all API calls:
where your_bidlogix_client_id is the id of your bidlogix web application id.
You must also substitute your domain into each call. For example, an API Call would look like this in documentation:
And this in practise:
There are substitutions / query string parameters specific to many calls. These are specified in their particular document.
(Note that there are slight adaptations for image related query string parameters, as described in the appropriate document. See UrlAttachmentAPIModel.)
Example results are given for each API within their specific document. You will find more information in our documents Common Data and Status Codes.
All requests return json by default. The format of GET requests can be changed to CSV by adding the parameter 'format'.