Name
Displays information about a telephony provider, including dial-in sequence, provider fields, and associated conference numbers.
Syntax
http://server_name/api/xml?action=telephony-provider-info&is-meeting-host=boolean&provider-id=integer&account-id=integer&principal-id=integer
Parameters
|
Required? |
Description |
provider-id |
Y |
Integer that specifies the provider ID for which information is to be retrieved. |
principal-id |
N |
Integer which, if specified, represents the principal ID of the user who created the provider. If not specified, this value is the principal ID of the currently logged-in user. |
account-id |
N |
If provider-id represents an account-level provider (that is, a provider that was not created by a user), this value is a string that specifies the ID of the account to which the provider belongs. If not specified, this value is the ID of the account of the logged-in user. |
is-meeting-host |
N |
A Boolean value that specifies whether provider-id is a user-configured provider. If this value is true, information is returned based on the value provided for principal-id. |
Permission
For a user-configured provider, you must have view permissions on the provider. For account-level providers, you must have view permission on the account.
Example
Request:
http://example.com/api/xml?action=telephony-provider-info&is-meeting-host=false&provider-id=11718&account-id=7
Response:
<results> <status code="ok"/> - <telephony-provider provider-id="11718" provider-type="integrated" token-length="0"> - <class-name> com.macromedia.breeze_ext.premiere.gateway.EMEA.PTekGateway </class-name> <adaptor-id>premiere-emea-adaptor</adaptor-id> <name>Premiere EMEA</name> <token-prefix>#4</token-prefix> <token-postfix>#</token-postfix> <provider-status>enabled</provider-status> </telephony-provider> - <telephony-provider-dial-in-info> <step provider-id="11718" sequence-number="1" field="11058" step-type="conf-num"/> - <step provider-id="11718" sequence-number="2" field="" step-type="delay"> <value>6000</value> </step> <step provider-id="11718" sequence-number="3" field="11059" step-type="dtmf"/> - <step provider-id="11718" sequence-number="4" field="" step-type="dtmf"> <value>#</value> </step> - <step provider-id="11718" sequence-number="5" field="" step-type="delay"> <value>5000</value> </step> </telephony-provider-dial-in-info> - <telephony-provider-fields> - <field provider-id="11718" field="11038" field-id="x-premiere-direct-phone" display-in-meeting="none" required="false" user-specified="true" input-type="text" is-hidden="true"> <name>Phone Number</name> </field> - <field provider-id="11718" field="11039" field-id="x-premiere-direct-phone-key" display-in-meeting="none" required="false" user-specified="false" input-type="text" is-hidden="true"> <name>{x-premiere-direct-phone-key}</name> </field> - <field provider-id="11718" field="11046" field-id="x-tel-premiere-sign-up-text" display-in-meeting="none" required="false" user-specified="false" input-type="text" is-hidden="false"> - <name> To learn more about Premiere Global or to sign up for a new account, please go to <u><a target="_blank" href="http://www.premiereglobal.com/adobeconnect/">http://www.premiereglobal.com/adobeconnect</a></u>. </name> </field> - <field provider-id="11718" field="11051" field-id="x-tel-premiere-emea-conference-number-part2" display-in-meeting="participants" required="false" user-specified="false" input-type="textarea" is-hidden="false"> <name>{x-tel-premiere-emea-conference-number-part2}</name> </field> - <field provider-id="11718" field="11052" field-id="x-tel-premiere-emea-conference-number-part3" display-in-meeting="participants" required="false" user-specified="false" input-type="textarea" is-hidden="false"> <name>{x-tel-premiere-emea-conference-number-part3}</name> </field> - <field provider-id="11718" field="11053" field-id="x-tel-premiere-emea-conference-number-part4" display-in-meeting="participants" required="false" user-specified="false" input-type="textarea" is-hidden="false"> <name>{x-tel-premiere-emea-conference-number-part4}</name> </field> - <field provider-id="11718" field="11054" field-id="x-tel-premiere-emea-conference-number-part5" display-in-meeting="participants" required="false" user-specified="false" input-type="textarea" is-hidden="false"> <name>{x-tel-premiere-emea-conference-number-part5}</name> </field> - <field provider-id="11718" field="11055" field-id="x-tel-premiere-emea-conference-number-part6" display-in-meeting="participants" required="false" user-specified="false" input-type="textarea" is-hidden="false"> <name>{x-tel-premiere-emea-conference-number-part6}</name> </field> - <field provider-id="11718" field="11056" field-id="x-tel-premiere-emea-conference-id" display-in-meeting="none" required="false" user-specified="false" input-type="text" is-hidden="true"> <name>{x-tel-premiere-emea-conference-id}</name> </field> - <field provider-id="11718" field="11057" field-id="x-tel-premiere-emea-conference-number" display-in-meeting="participants" required="false" user-specified="false" input-type="textarea" is-hidden="false"> <name>Conference Number(s)</name> </field> - <field provider-id="11718" field="11058" field-id="x-tel-premiere-emea-uv-conference-number" display-in-meeting="none" required="false" user-specified="false" input-type="text" is-hidden="true"> <name>{x-tel-premiere-emea-uv-conference-number}</name> </field> - <field provider-id="11718" field="11059" field-id="x-tel-premiere-emea-participant-code" display-in-meeting="participants" required="false" user-specified="false" input-type="text" is-hidden="false"> <name>Participant Code</name> </field> - <field provider-id="11718" field="11060" field-id="x-tel-premiere-emea-user-id" display-in-meeting="none" required="true" user-specified="true" input-type="text" is-hidden="false"> <name>Client ID</name> </field> - <field provider-id="11718" field="11061" field-id="x-tel-premiere-emea-password" display-in-meeting="none" required="true" user-specified="true" input-type="password" is-hidden="false"> <name>Premiere Password</name> </field> - <field provider-id="11718" field="11062" field-id="x-tel-premiere-emea-moderator-code" display-in-meeting="hosts" required="true" user-specified="true" input-type="text" is-hidden="false"> <name>Moderator Code</name> </field> </telephony-provider-fields> </results>