This section should help a 3rd party developer understand how the remote API system works. If you have any questions that are not answered here, feel free to send an e-mail to [email protected] and we would be happy to address any specific questions you might have.

You interact with the Remote API by making a remote API call. There are different types of calls that do different things, for instance anything related to use sessions, would start with "session.".

Below is a run down of all the current Geo API calls that are built into the main software, and a brief summary of what they are used for. For more information on using any of the remote API calls, look at the PHP source code of the applicable "sample file".

View the source on any of the sample client files. Each one will have in-line comments on how to use it, along with variables that you will have to set to use it.

Each sample file is a fully working standalone script that makes use of the applicable remote API call, but you must follow the instructions to set it up. For your reference, here are the "common" set of instructions that apply to most of the stand-alone sample scripts.

Code snippet from one of the files in classes/api/_samples/:

/*
Note: This is intended for people that are familiar with editing PHP
	files.
 
Instructions for using this as a stand-alone API client:
1.	Edit this file:  Look for the line that starts with "$xmlrpc_location".
	Change it to:
	$xmlrpc_location = "XMLRPC.class.php";
2.	Set the rest of the "Required Settings" as needed (like $website, $api_key, etc)
	Each setting has its own instructions right above it.
 
	There may be optional settings as well, those can be set by
	un-commenting them and set them as instructed.
3.	Upload the modified file to a location that you can access from the web.
	It does not have to be on the same website as the Geo software.
4.	Upload the file "XMLRPC.class.php" to the same location that you uploaded
	this file to.  The file is located in the Geo software at:
	classes/rpc/XMLRPC.class.php
5.	In a web browser, visit the file you uploaded in step 3.  You should see
	the results of the API call.
*/

Note that you can create a new API call, inside of an addon. As long as that addon is installed and enabled, you will be able to use the API call.

Before creating a new remote API call yourself, if it makes sense for the API call to be one of the built-in calls (for instance, an API call to get the listing data for a particular listing), but is just not yet created, contact us as [email protected] to request it. Every single remote API call that is currently in existance, has been created because it is "in demand" (just like most of the current "addon hooks").

To create your own remote API call in your custom addon, create a sub-directory named "api" inside of the addon's directory. Then you would create a PHP file for any API call you want to make. Any files that are prepended with an underscore "_" will be ignored by the system. We recommend starting from the misc.echo remote API call and building on top of that. You can also see the Example Addon for more information about creating a new remote API call.

• Remote API Security Keys - Page that shows the Remote API security keys for every single API call, something you will need when making an API call. See any of the sample remote API clients in classes/api/_samples/ for more info.