SWHelp:StampWants API URL

From StampWantsWiki

Jump to: navigation, search

Regardless of the programming language you are using, all requests and posts must be done via HTTP. Requests and Posts must be made to the StampWants API File Command URL which is:

http://www.stampwants.com/filecommand.php

OR (for HTTPS)

https://www.stampwants.com/filecommand.php

However, the following variable must also be sent along with the File Command URL. These additional variables (as well as other additional variables defined in other sections of the developers guide) may be sent as either GET or POST variables. For simplicity we recommend sending the additional parameters as GET variables. For this reason the rest of this guide will include any additional File Command variables as GET variables (they appear directly in the File Command URL).

The following three fields are required for all StampWants API calls:

PLEASE NOTE: All variable names and values are case sensitive.

Field Name Allowed Values Description
username text The username associated with the StampWants account you are attempting to access. Usernames are not case sensitive.
password text The password associated with the StampWants account you are attempting to access. Passwords are case sensitive.
type selling, sold, unsold, bidding, watching, won, lost, pending or upload The type of information you are requesting, or 'upload' if you are posting a csv file. See the Requesting Information from StampWants page for more information on this field.

Here is an example of what the File Command URL would look like if you were trying to access the StampWants account: myUserName, with the password of: myPassWord, and you wanted to download all of the active listings for myUserName:

http://www.stampwants.com/filecommand.php?username=myUserName&password=myPassWord&type=selling
Personal tools
stampwants main site