mod_xml_rpc

About

mod_xml_rpc allows you to use the webapi - firing any API from the web browser just as you would from the FS console!

API command documentation can be found in the mod_commands section.

webapi

To use, you must enable this module within the conf/autoload_configs/modules.conf.xml file and restart the switch. You can configure the module (HTTP port, domain, login/password) within the conf/autoload_configs/xml_rpc.conf.xml file.

The basic syntax would be:

http://<freeswitch-hostname-or-IP>:8080/webapi/<api command>

For example:

http://192.168.1.1:8080/webapi/help

Requires:

• HTTP only, no HTTPS
• port 8080
• Typical HTTP authentication - username, password (default is freeswitch/works)

Generally, the web root is {prefix}/freeswitch/htdocs.

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

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.

Example:

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

Returning data to the webpage using Lua and stream:write

To execute a FS command from a web page and display the result in the webpage use:

http://127.0.0.1:8080/api/lua?lua/api.lua

Using webapi with curl

Examples:

show channels, text output

curl -s -S -G -X GET \
      --user login:password  \
      --data-urlencode "channels" \
      'http://127.0.0.1:8080/xmlapi/show'

output

uuid,direction,created,created_epoch,name,state,cid_name,cid_num,ip_addr,dest,application,application_data,dialplan,context,read_codec,read_rate,read_bit_rate,write_codec,write_rate,write_bit_rate,secure,hostname,presence_id,presence_data,accountcode,callstate,callee_name,callee_num,callee_direction,call_uuid,sent_callee_name,sent_callee_num,initial_cid_name,initial_cid_num,initial_ip_addr,initial_dest,initial_dialplan,initial_context
5d2ae508-ab6b-11ea-88cb-311ce82e049e,inbound,2020-06-10 18:40:20,1591828820,sofia/internal/1019@192.0.2.10,CS_EXECUTE,1019,1019,192.0.2.50,55,echo,,XML,default,PCMU,8000,64000,PCMU,8000,64000,,hostname.local,1019@192.0.2.10,,1019,ACTIVE,,,,,,,1019,1019,192.0.2.50,55,XML,default

1 total.

show channels, xml output

curl -s -S -G -X GET \
      --user login:password  \
      --data-urlencode "channels as xml" \
      'http://127.0.0.1:8080/xmlapi/show'

output

<result row_count="1">
  <row row_id="1">
    <uuid>5d2ae508-ab6b-11ea-88cb-311ce82e049e</uuid>
    <direction>inbound</direction>
    <created>2020-06-10 18:40:20</created>
    <created_epoch>1591828820</created_epoch>
    <name>sofia/internal/1019@192.0.2.10</name>
    <state>CS_EXECUTE</state>
    <cid_name>1019</cid_name>
    <cid_num>1019</cid_num>
    <ip_addr>192.0.2.50</ip_addr>
    <dest>55</dest>
    <application>echo</application>
    <application_data></application_data>
    <dialplan>XML</dialplan>
    <context>default</context>
    <read_codec>PCMU</read_codec>
    <read_rate>8000</read_rate>
    <read_bit_rate>64000</read_bit_rate>
    <write_codec>PCMU</write_codec>
    <write_rate>8000</write_rate>
    <write_bit_rate>64000</write_bit_rate>
    <secure></secure>
    <hostname>hostname.local</hostname>
    <presence_id>1019@192.0.2.10</presence_id>
    <presence_data></presence_data>
    <accountcode>1019</accountcode>
    <callstate>ACTIVE</callstate>
    <callee_name></callee_name>
    <callee_num></callee_num>
    <callee_direction></callee_direction>
    <call_uuid></call_uuid>
    <sent_callee_name></sent_callee_name>
    <sent_callee_num></sent_callee_num>
    <initial_cid_name>1019</initial_cid_name>
    <initial_cid_num>1019</initial_cid_num>
    <initial_ip_addr>192.0.2.50</initial_ip_addr>
    <initial_dest>55</initial_dest>
    <initial_dialplan>XML</initial_dialplan>
    <initial_context>default</initial_context>
  </row>
</result>

show channels, json output

curl -s -S -G -X GET \
      --user login:password  \
      --data-urlencode "channels as json" \
      'http://127.0.0.1:8080/xmlapi/show' | jq

output

{
  "row_count": 1,
  "rows": [
    {
      "uuid": "5d2ae508-ab6b-11ea-88cb-311ce82e049e",
      "direction": "inbound",
      "created": "2020-06-10 18:40:20",
      "created_epoch": "1591828820",
      "name": "sofia/internal/1019@192.0.2.10",
      "state": "CS_EXECUTE",
      "cid_name": "1019",
      "cid_num": "1019",
      "ip_addr": "192.0.2.50",
      "dest": "55",
      "application": "echo",
      "application_data": "",
      "dialplan": "XML",
      "context": "default",
      "read_codec": "PCMU",
      "read_rate": "8000",
      "read_bit_rate": "64000",
      "write_codec": "PCMU",
      "write_rate": "8000",
      "write_bit_rate": "64000",
      "secure": "",
      "hostname": "hostname.local",
      "presence_id": "1019@192.0.2.10",
      "presence_data": "",
      "accountcode": "1019",
      "callstate": "ACTIVE",
      "callee_name": "",
      "callee_num": "",
      "callee_direction": "",
      "call_uuid": "",
      "sent_callee_name": "",
      "sent_callee_num": "",
      "initial_cid_name": "1019",
      "initial_cid_num": "1019",
      "initial_ip_addr": "192.0.2.50",
      "initial_dest": "55",
      "initial_dialplan": "XML",
      "initial_context": "default"
    }
  ]
}

uuid_setvar

curl -s -S -G -X GET \
      --user login:password   \
      --data-urlencode "<uuid> record_sample_rate 8000" \
      'http://127.0.0.1:8080/xmlapi/uuid_setvar'

start stream rtmp

curl -s -S -G -X GET \
      --user login:password   \
      --data-urlencode "<uuid> start rtmp://domain.local/stream:teststream" \
      'http://127.0.0.1:8080/xmlapi/uuid_record'

use uuid_buglist

curl -s -S -G -X GET \
      --user login:password   \
      --data-urlencode "<uuid>" \
      'http://127.0.0.1:8080/xmlapi/uuid_buglist'

output

<media-bugs>
 <media-bug>
  <function>session_record</function>
  <target>rtmp://domain.local/stream:teststream</target>
  <thread-locked>0</thread-locked>
 </media-bug>
</media-bugs>

Initiate call with silence in channel

curl -s -S -G -X GET \
       --user login:password \
       --data-urlencode "{origination_caller_id_number={number from}}sofia/{profile}/sip:{user}@{domain} silence XML play" \
       'http://127.0.0.1:8080/xmlapi/originate'

play.xml

<include>
  <context name="play">
    <extension name="play-silence_stream" continue="true">
      <condition field="destination_number" expression="^silence$">
        <action application="answer"/>
        <action application="endless_playback" data="silence_stream://-1"/>
      </condition>
    </extension>
  </context>
</include>

Start stream media in the channel

curl -s -S -G -X GET \
      --user login:password  \
      --data-urlencode "{uuid} {/path/to/file/file} both" \
      'http://127.0.0.1:8080/xmlapi/uuid_broadcast'

Pause/resume stream in the channel

curl -s -S -G -X GET \
      --user login:password  \
      --data-urlencode "{uuid} pause" \
      'http://127.0.0.1:8080/xmlapi/uuid_fileman'

Stop stream in the channel

curl -s -S -G -X GET \
      --user login:password  \
      --data-urlencode "{uuid} stop" \
      'http://127.0.0.1:8080/xmlapi/uuid_fileman'

Stop call

curl -s -S -G -X GET \
      --user login:password  \
      --data-urlencode "{uuid}" \
      'http://127.0.0.1:8080/xmlapi/uuid_kill'

See also

• Examples of calling mod_xml_rpc from various languages
• http://wiki.freeswitch.org/wiki/Webapi
• Freeswitch Portal
• FreeSWITCH XML-RPC

Comments:

In page FreeSWITCH XML-RPC I can find the freeswitch.api examples,but where can I find the freeswitch.management some examples ? Posted by livem at May 09, 2019 06:05