ВОЙТИ

Scenarios

Methods

AddScenario

Adds a new scenario. Please use the POST method.

Parameters

  • Follow link for authentication parameter names and details.

  • scenario_name:

    string

    The scenario name. The length must be less than 30

  • scenario_script:

    string
    OPTIONAL

    The scenario text. The length must be less than 128 KB.

  • rule_id:

    number
    OPTIONAL

    The rule ID.

  • rule_name:

    string
    OPTIONAL

    The rule name that can be used instead of rule_id.

  • rewrite:

    boolean
    OPTIONALЗНАЧЕНИЕ ПО УМОЛЧАНИЮ:  false

    Is the existing scenario rewrite?

Returns

  • result:

    number

    1

  • scenario_id:

    number

    The new scenario ID.

Примеры

запрос:

Add a new scenario: var s='hello';

https://api.voximplant.com/platform_api/AddScenario/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&scenario_name=scen1&scenario_script=var%20s%3D%22hello%22%3B

ответ:

Add a new scenario: var s='hello';

{
    "result": 1,
    "scenario_id": 1
}

BindScenario

Bind the scenario list to the rule. You should specify the application_id or application_name if you specify the rule_name.

Parameters

  • Follow link for authentication parameter names and details.

  • scenario_id:

    intlist

    The scenario ID list separated by the ';' symbol.

  • scenario_name:

    stringlist

    Can be used instead of scenario_id. The scenario name list separated by the ';' symbol.

  • rule_id:

    number

    The rule ID.

  • rule_name:

    string

    The rule name that can be used instead of rule_id.

  • application_id:

    number

    The application ID.

  • application_name:

    string

    The application name that can be used instead of application_id.

  • bind:

    boolean
    OPTIONALЗНАЧЕНИЕ ПО УМОЛЧАНИЮ:  true

    Bind or unbind?

Returns

  • result:

    number

    1

Примеры

запрос:

Bind the scenarios 1, 2 and 3 with the rule 1.

https://api.voximplant.com/platform_api/BindScenario/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&scenario_id=1%3B2%3B3&rule_id=1

ответ:

Bind the scenarios 1, 2 and 3 with the rule 1.

{
    "result": 1
}

DelScenario

Deletes the scenario.

Parameters

  • Follow link for authentication parameter names and details.

  • scenario_id:

    intlist

    The scenario ID list separated by the ';' symbol or the 'all' value.

  • scenario_name:

    stringlist

    Can be used instead of scenario_id. The scenario name list separated by the ';' symbol.

Returns

  • result:

    number

    1

Примеры

запрос:

Delete the scenario 1 and 3.

https://api.voximplant.com/platform_api/DelScenario/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&scenario_id=1%3B3

Delete the all scenarios.

https://api.voximplant.com/platform_api/DelScenario/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&scenario_id=all

ответ:

Delete the all scenarios.

{
    "result": 1
}

GetScenarios

Gets the account's scenarios.

Parameters

  • Follow link for authentication parameter names and details.

  • scenario_id:

    number
    OPTIONAL

    The scenario ID to filter

  • scenario_name:

    string
    OPTIONAL

    The scenario name to filter. Can be used instead of scenario_id. All scenarios containing this param in their names will be returned. The parameter is case insensitive.

  • with_script:

    boolean
    OPTIONALЗНАЧЕНИЕ ПО УМОЛЧАНИЮ:  false

    Set true to get the scenario text. You must specify the 'scenario_id' too!

  • count:

    number
    OPTIONALЗНАЧЕНИЕ ПО УМОЛЧАНИЮ:  20

    The max returning record count.

  • offset:

    number
    OPTIONALЗНАЧЕНИЕ ПО УМОЛЧАНИЮ:  0

    The first N records will be skipped in the output.

Returns

  • result:

    [ ScenarioInfoType ]
  • total_count:

    number

    The total found scenario count.

  • count:

    number

    The returned scenario count.

Примеры

запрос:

Get two scenarios, but skip the first one.

https://api.voximplant.com/platform_api/GetScenarios/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&offset=1&count=2

ответ:

Get two scenarios, but skip the first one.

{
    "count": 2,
    "result": [
        {
            "modified": "2013-09-09 16:35:55",
            "scenario_id": 2,
            "scenario_name": "scen2"
        },
        {
            "modified": "2013-09-09 16:36:50",
            "scenario_id": 3,
            "scenario_name": "scen3"
        }
    ],
    "total_count": 4
}

ReorderScenarios

Configures the order of scenarios that are assigned to the specified rule.

Parameters

  • Follow link for authentication parameter names and details.

  • rule_id:

    number

    The rule ID.

  • rule_name:

    string

    The rule name that can be used instead of rule_id.

  • scenario_id:

    intlist
    OPTIONAL

    The scenario ID list separated by the ';' symbol.

Returns

  • result:

    number

    1

Примеры

запрос:

Set the scenario loading order: 17, 15, 20.

https://api.voximplant.com/platform_api/ReorderScenarios/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&rule_id=2&scenario_id=17%3B15%3B20

ответ:

Set the scenario loading order: 17, 15, 20.

{
    "result": 1
}

SetScenarioInfo

Edits the scenario. Please use the POST method.

Parameters

  • Follow link for authentication parameter names and details.

  • scenario_id:

    number

    The scenario ID.

  • required_scenario_name:

    string

    The name of the scenario to edit, can be used instead of scenario_id.

  • scenario_name:

    string
    OPTIONAL

    The new scenario name. The length must be less than 30

  • scenario_script:

    string
    OPTIONAL

    The new scenario text. The length must be less than 128 KB.

Returns

  • result:

    number

    1

Примеры

запрос:

Add a new scenario: var s='hello';

https://api.voximplant.com/platform_api/SetScenarioInfo/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&scenario_id=1&scenario_name=scen11&scenario_script=var%20s%3D%22hello%20world%22%3B

ответ:

Add a new scenario: var s='hello';

{
    "result": 1
}

StartConference

Runs a session for video conferencing or joins the existing video conference session.

When a session is created by calling this method, a scenario assigned to the specified rule_id will run on one of the servers dedicated to video conferencing. All further method calls with the same rule_id won't create a new video conference session, but join the already existing one.

Use the StartScenarios method for creating audio conferences.

Parameters

  • Follow link for authentication parameter names and details.

  • conference_name:

    string

    The conference name. The name length must be less than 50 symbols.

  • rule_id:

    number

    The rule ID.

  • user_id:

    number
    OPTIONAL

    The user ID. Run the scripts from the user if set.

  • user_name:

    string
    OPTIONAL

    The user name that can be used instead of user_id. Run the scripts from the user if set.

  • application_id:

    number
    OPTIONAL

    The application ID.

  • application_name:

    string
    OPTIONAL

    The application name that can be used instead of application_id.

  • script_custom_data:

    string
    OPTIONAL

    The script custom data (like a script argument). Can be accessed in JS scenario via the VoxEngine.customData() method

  • reference_ip:

    string
    OPTIONAL

    Specifies the IP from the geolocation of predicted subscribers. It allows selecting the nearest server for serving subscribers.

Returns

  • result:

    number

    1

  • media_session_access_url:

    string

    The URL to control a created media session. It can be used for arbitrary tasks such as stopping scenario or passing additional data to it. Making HTTP request on this URL will result in the AppEvents.HttpRequest VoxEngine event being triggered for a scenario, with an HTTP request data passed to it.

  • media_session_access_secure_url:

    string

    The URL to control a created media session. It can be used for arbitrary tasks such as stopping scenario or passing additional data to it. Making HTTPS request on this URL will result in the AppEvents.HttpRequest VoxEngine event being triggered for a scenario, with an HTTP request data passed to it.

Примеры

запрос:

Start the conference from the account.

https://api.voximplant.com/platform_api/StartConference/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&conference_name=boss&rule_id=1&script_custom_data=mystr

Start the conference from the user 1.

https://api.voximplant.com/platform_api/StartConference/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&conference_name=boss&rule_id=1&script_custom_data=mystr&user_id=1

ответ:

Start the conference from the user 1.

{
    "result": 1,
    "media_session_access_url": "http:\/\/1.2.3.4:12092\/request\/eb769701de54cfa5.1539237068.6369268_1.2.3.4\/1df792ad965d7105",
    "media_session_access_secure_url": "https:\/\/1.2.3.4:12092\/request\/eb769701de54cfa5.1539237068.6369268_1.2.3.4\/1df792ad965d7105"
}

StartScenarios

Runs JavaScript scenarios on a VoxImplant server. The scenarios run in a new media session.

Parameters

  • Follow link for authentication parameter names and details.

  • user_id:

    number
    OPTIONAL

    The user ID. Run the scripts from the user if set.

  • user_name:

    string
    OPTIONAL

    The user name that can be used instead of user_id. Run the scripts from the user if set.

  • application_id:

    number
    OPTIONAL

    The application ID.

  • application_name:

    string
    OPTIONAL

    The application name that can be used instead of application_id.

  • rule_id:

    number

    The rule ID.

  • script_custom_data:

    string
    OPTIONAL

    The script custom data (like a script argument). Can be accessed in JS scenario via the VoxEngine.customData() method

  • reference_ip:

    string
    OPTIONAL

    Specifies the IP from the geolocation of predicted subscribers. It allows selecting the nearest server for serving subscribers.

Returns

  • result:

    number

    1

  • media_session_access_url:

    string

    The URL to control a created media session. It can be used for arbitrary tasks such as stopping scenario or passing additional data to it. Making HTTP request on this URL will result in the AppEvents.HttpRequest VoxEngine event being triggered for scenario, with HTTP request data passed to it.

  • media_session_access_secure_url:

    string

    The URL to control a created media session. It can be used for arbitrary tasks such as stopping scenario or passing additional data to it. Making HTTPS request on this URL will result in the AppEvents.HttpRequest VoxEngine event being triggered for scenario, with HTTP request data passed to it.

Примеры

запрос:

Start the scripts from the account.

https://api.voximplant.com/platform_api/StartScenarios/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&rule_id=1&script_custom_data=mystr

Start the scripts from the user 1.

https://api.voximplant.com/platform_api/StartScenarios/?account_id=1&api_key=eec36d6c-a0eb-46b5-a006-1c2b65343bac&rule_id=1&script_custom_data=mystr&user_id=1

ответ:

Start the scripts from the user 1.

{
    "result": 1,
    "media_session_access_url": "http:\/\/1.2.3.4:12092\/request\/eb769701de54cfa5.1539237068.6369268_1.2.3.4\/1df792ad965d7105",
    "media_session_access_secure_url": "https:\/\/1.2.3.4:12092\/request\/eb769701de54cfa5.1539237068.6369268_1.2.3.4\/1df792ad965d7105"
}