Revision [1459]

This is an old revision of APIDocumentation made by PhilDaintree on 2009-04-30 20:51:22.

 

webERP API


This is the for dummies version - since that is the standpoint I am looking at it from!!

The API uses the phpxmlrpc class from Useful Inc originally developed by Edd Dumbill

(Why didn't you use the PHP built in stuff Tim? I believe it was based on this class?)

xml-rpc is a protocl to use XML to make RPC - remote procedure calls.

Simply put the XML_RPC call is XML that contains the method of the remote procedure call and any parameters and their data types and is sent over http to the XML-RPC server - the server returns an XML payload containing the results of the call.

The clever thing about XML-RPC is that it is the simplest protocol around for doing web-services. The newer and MUCH more complex SOAP - Simple Object Access Protocol - is quite involved and complicated and therefore doesn't belong in webERP!!

In fact this XML-RPC "Server" in webERP is just the script:

http://www.yourdomain.com/webERP/api/api_xml-rpc.php


there is no daemon required to field calls to the "server" it is just a script that is http posted to by the XML-RPC call sending the XML encoded method to be run together with the necessary parameters to the webERP API - the server script runs Tim's php functions exposed by the xml-rpc methods and returns the XML-RPC response as an XML payload. The phpxmlrpc class does the packaging converting the PHP variables and arrays to the XML required for the XML-RPC call and also has the functions to convert the XML response into something useable in PHP without having to write the XML parsing routines.

I read a how-to on XML-RPC with PHP which contains a little more detail of what is going on and was a useful primer for the concepts.

Tim's API help which itself is produced by an xml-rpc call to the API using the system.listMethods method (I think this is a phpxmlrpc method - not a webERP API method) - he then uses another system xml-rpc method of phpxmlrpc class to return the details of each method's parameters required. So the help file not only documents each of the API methods it is itself and illustration of how the API can be used!!

<?php
//if your webERP install is on a server at http://www.yourdomain.com/webERP
$ServerURL = "http://www.yourdomain.com/webERP/api/api_xml-rpc.php";
$DebugLevel = 0; //Set to 0,1, or 2 with 2 being the highest level of debug info

$Parameters = array();
$Parameters['StockID'] = 'DVD_TOPGUN'; //the stockid of the item we wish to know the balance for
//assuming the demo username and password will work !
$Parameters['Username'] = 'admin';
$Parameters['Password'] = 'weberp';

$msg = new xmlrpcmsg("weberp.xmlrpc_GetStockBalance", $Parameters);

$client = new xmlrpc_client($ServerURL);
$client->setDebug($DebugLevel);
$response = $client->send($msg);
$signature = php_xmlrpc_decode($response->value());

?>
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki