It's all in mod_xml_rpc.

 

I've been trying to get it all doc'd but I'm way behind... :-)  Of
course, I'm the guilty party for putting "webapi" in the mod_perl page
on the wiki. Sadly, "webapi" shows up only on this page which means I'm
slacking. This page needs some love:

 

http://wiki.freeswitch.org/wiki/Mod_xml_rpc

 

If you can wikify some of this knowledge that would be great. Here are
some quick tips regarding the built-in Abyss web server:

HTTP only, no HTTPS; use port 8080

Accessed via URL like so: http://192.168.1.1:8080/

Need username/password (typical HTTP authentication I believe)

  Username/password can be modified in
conf/autoload_configs/xml_rpc.conf.xml

The "webroot" on a typical *nix install is /usr/local/freeswitch/htdocs

  http://192.168.1.1:8080/ will give a directory listing of
/usr/local/freeswitch/htdocs

  Other HTML/JavaScript/etc. files in htdocs will get served up as
requested

 

There are various API access methods: api, webapi, txtapi

  Each does something a little different depending upon the scenario

 

When using an API command that has more than one word, use a question
mark to separate the first and second words, then a space for the rest

  (See examples below)

 

Try these different combos on your own install; be sure to enable
mod_xml_rpc in modules.conf.xml!

Replace the sample IP address (192.168.1.1) with your actual FS IP
address.

 

http://192.168.1.1:8080/api/version

http://192.168.1.1:8080/webapi/version

http://192.168.1.1:8080/txtapi/version

 

http://192.168.1.1:8080/api/show?channels

http://192.168.1.1:8080/webapi/show?channels

http://192.168.1.1:8080/txtapi/show?channels

 

http://192.168.1.1:8080/api/sofia?status%20profile%20internal 

http://192.168.1.1:8080/webapi/sofia?status%20profile%20internal 

http://192.168.1.1:8080/txtapi/sofia?status%20profile%20internal 

 

For kicks, try these:

http://192.168.1.1:8080/api/help

http://192.168.1.1:8080/webapi/help

http://192.168.1.1:8080/txtapi/help

 

Depending upon the API command being used, the api/webapi/txtapi choice
will differ. I recommend playing with it to figure out which one works
best for you. Sometimes you'll like the way that webapi wraps your
output in nice tables w/ alternating background colors. Sometimes the
output of the API command doesn't support that fancy wrapping. As you
tinker you'll see which method works best for the commands you want to
use.

 

You can access just about anything you could otherwise type at the FS
CLI:

http://192.168.1.1:8080/webapi/<insert-your-commands-here>

 

If you like it, doc it! :-)

 

-MC

 

P.S. - for extra fun try this one:
http://192.168.1.1:8080/api/voicemail/web

 

 

________________________________

From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On Behalf Of
Gayatri Kulkarni
Sent: Tuesday, October 14, 2008 10:49 PM
To: [email protected]
Subject: Re: [Freeswitch-users] HTTP methods

 

great! I found an occurece of "webapi" in the documentation for mod_perl

but, is this share generated when we install FS, or when we enable
mod_xm_rpc or something, because i can't find it created on my system.
If yes, what is it's default path?
Or, do I have to create it and implement the HTTP methods myself??


-- 
Regards,
Gayatri Kulkarni

On Tue, Oct 14, 2008 at 6:49 PM, Anthony Minessale
<[EMAIL PROTECTED]> wrote:

there is a special /api /webapi and /textapi share on the site that will
point at any api command doing GET or POST

for instance:
/webapi/status

I'm pretty sure it's documented somewhere.



On Tue, Oct 14, 2008 at 6:57 AM, Gayatri Kulkarni
<[EMAIL PROTECTED]> wrote:

        Hi Guys,
        
        The XmlRpc is implemented from the web port - 8080
        Can we also specify which HTTP methods FS implements - like GET,
POST, PUT, DELETE, etc ??
        in xml_rpc.conf.xml or some place ....?
        Is there a way to implement these?
        
        -- 
        Regards,
        Gayatri Kulkarni

         

        _______________________________________________
        Freeswitch-users mailing list
        [email protected]
        http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
        
UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users
        http://www.freeswitch.org




-- 
Anthony Minessale II

FreeSWITCH http://www.freeswitch.org/
ClueCon http://www.cluecon.com/

AIM: anthm
MSN:[EMAIL PROTECTED]
<mailto:[EMAIL PROTECTED]> 
GTALK/JABBER/PAYPAL:[EMAIL PROTECTED]
<mailto:[EMAIL PROTECTED]> 
IRC: irc.freenode.net #freeswitch

FreeSWITCH Developer Conference
sip:[EMAIL PROTECTED]
<mailto:[EMAIL PROTECTED]> 
iax:[EMAIL PROTECTED]/888
googletalk:[EMAIL PROTECTED]
<mailto:[EMAIL PROTECTED]> 
pstn:213-799-1400


_______________________________________________
Freeswitch-users mailing list
[email protected]
http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users
http://www.freeswitch.org

 

_______________________________________________
Freeswitch-users mailing list
[email protected]
http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
UNSUBSCRIBE:http://lists.freeswitch.org/mailman/options/freeswitch-users
http://www.freeswitch.org

Reply via email to