http://wiki.parspooyesh.com/index.php?action=history&feed=atom&title=XML-RPC 2026-06-24T14:16:49Z تاریخچهٔ ویرایشهای صفحه در ویکی MediaWiki 1.19.0 http://wiki.parspooyesh.com/index.php?title=XML-RPC&diff=121&oldid=prev 2011-09-03T07:53:58Z

<p>صفحه‌ای جدید حاوی &#039;<a href="/index.php/%D8%B1%D8%AF%D9%87:Programming" title="رده:Programming">Category:Programming</a> __TOC__ &lt;div dir=ltr lang=en&gt; ==What is XML-RPC?== [[http://en.wikipedia.org/wiki/XML-RPC Wikipedia Article on XML-RP...&#039; ایجاد کرد</p> <p><b>صفحهٔ جدید</b></p><div>[[Category:Programming]]<br /> __TOC__<br /> &lt;div dir=ltr lang=en&gt;<br /> <br /> <br /> ==What is XML-RPC?==<br /> [[http://en.wikipedia.org/wiki/XML-RPC Wikipedia Article on XML-RPC]]&lt;br&gt;<br /> [[http://www.xmlrpc.com/ XML-RPC HomePage]]<br /> <br /> ==IBSng as an XML-RPC SERVER==<br /> IBSng Composed of two major systems. The most important and critical part is a service that runs on start of the system and remains on memory. This system called core. The other is interface that shows informations to users and get the input data.<br /> Everything outside core talks to core by using xml-rpc protocol. None of other systems access to database directly. Only core is allowed to connect to database. This is mandatory because core caches many informations in memory, and changing database directly doesn't invalidate the cache.<br /> By default, IBSng core listens on 127.0.0.1 tcp port 1235. If you want to connect from outside to IBSng, you need to receonfigure IBSng.conf and change bind_ip directive to listen on 0.0.0.0 (all interfaces)<br /> <br /> ===Request Format===<br /> All requests to IBSng core has a method name and a single argument.<br /> The method name is in format HANDLER_NAME.HANDLE_METHOD (ex user.addNewUser).<br /> The single argument is an associative array that contains real arguments of handler. Associative array is represented by xml-rpc struct. Ex. <br /> &lt;pre&gt;array(“count”=&gt;1, “credit”=&gt;10)&lt;/pre&gt;<br /> <br /> ===Authentication===<br /> IBSng Core authenticates every request that it receives before processing. So The associative array always should contain 3 authentication parameters. <br /> auth_type: Role of the requester. Can be ADMIN, NORMAL_USER, VOIP_USER or ANONYMOUS<br /> auth_name: Username of requester. Should be ANONYMOUS for ANONYMOUS auth_type.<br /> auth_pass: Password of requester.<br /> <br /> Trusted Clients can pass another argument used to recongnize real client ip address<br /> auth_remoteaddr: Remote Address of requester.<br /> <br /> If client is not in trusted clients list (by default only 127.0.0.1 is), the connection ip address is used for remote_address.<br /> <br /> <br /> Ex. <br /> &lt;pre&gt;method:user.addNewUser<br /> Arguement: array (“auth_name”=&gt;”system”, “auth_pass”=&gt;”sys”, “auth_type”=&gt;”ADMIN”,<br /> ”count”=&gt;1, “credit”=&gt;20.0, “owner_name”=&gt;”system”, “group_name”=&gt;”test_group”, “credit_comment”=&gt;””)&lt;/pre&gt;<br /> <br /> <br /> ===Handlers And Arguments===<br /> There are plenty of registered handlers in IBSng that used by many other systems to perform needed actions. For example handler “user” is used for user management, and handler “ias” is used by and outside accouting software.<br /> Each handler has some registered methods. For example handler user has “user.addNewUser” and “user.getUserInfo” among other methods. A list of all handlers and their methods can be found in XML-RPC API document.<br /> <br /> Some methods need a group of specific arguments be available in request associative array. '''“user.addNewUser”''' needs “count”,”credit”,”owner_name”,”group_name”,”credit_comment” always be available in request. If request was incomplete, and xml-rpc error will be returned with message incomplete request.<br /> <br /> Some methods has optional arguments too. “user.getUserInformation” can give client user information based on “user_id” or “normal_username” or “voip_username”. So it only needs one of these arguments to be present in request. Optional arguments are always tagged in API documentation.<br /> <br /> [[IBSng_Handler_Reference]]<br /> &lt;/div&gt;</div>

Support