ProSBC:Restful API SIP Domain: Difference between revisions

Revision as of 11:25, 3 March 2023

You can create and modify a SIP Domain in your system with RestFul API using JSON in the following format:


{
    "min_contact_expire": "30 seconds",
    "max_contact_expire": "1 hour",
    "enabled": true,
    "routing_method": "Register Source",
    "domain_name": "sip.telcobridges.com",
    "advanced_parameters": {
        "poll_registered_users_parameters": {
            "***meta***": {
                "valid_url": false
            },
            "poll_registered_users_interval": "20 seconds",
            "poll_registered_users_user_agent": "",
            "poll_registered_users": false
        },
        "unsubscribe_on_unregister": true,
        "***meta***": {
            "valid_url": false
        },
        "contact_expire_grace_time": "1 minute",
        "strict_user_matching": false
    },
    "sip_registration_registrars": {},
    "***meta***": {
        "version": "3.1.137",
        "src_path": ""
    },
    "naps": [
        "3CX",
        "OPEN_NAP"
    ],
    "default_contact_expire": "1 hour",
    "forwarding_parameters": {
        "forwarding_mode": "Contact Remapping",
        "***meta***": {
            "valid_url": false
        },
        "forward_after_switchover": true,
        "override_received_user_agent": false,
        "max_simultaneous_register_forward": 10000,
        "max_pending_register_forward": 10000,
        "min_registrar_expire": "1 hour"
    },
    "name": "TEST_DOMAIN",
    "unique_name": "sip.telcobridges.com",
    "registration_method": "Forwarding",
    "max_registered_users": 100000
}

Important parameters in the JSON file

Adding a new SIP Domain

You can add a new SIP Domain with the POST command:

POST http://ProSBCIP:12358/configurations/configuration_name//sip_registration_domains/

ProSBC will create a new SIP Domain from the name in the JSON file.

Example: Using the Postman tool, the URL is:

http://192.168.1.25:12358/configurations/config_2/sip_registration_domains/

If the new SIP Domain is created successfully, the following message is returned:

Modifiying a SIP Domain

You can modify the existing SIP Domain with the PUT command:

PUT http://ProSBCIP:12358/configurations/configurationname/sip_registration_domains/sip_domain_name

Example: Using the Postman tool, the URL is

http://192.168.1.25:12358/configurations/config_2/sip_registration_domains/TEST_DOMAIN and changed routing_method to Contact

If the update is successful, the following message is returned:

Learn more about how to use RestFul API and Postman Tool from the following link Northbound_interface:RESTful.

@@ Line 1: / Line 1: @@
-You can create and modify a SIP Domain in your system with RestFul API using JSON format. The JSON must be in the following format:
+You can create and modify a SIP Domain in your system with RestFul API using JSON in the following format:
 <pre>
@@ Line 70: / Line 70: @@
 ProSBC will create a new SIP Domain from the name in the JSON file.
-Example: We use the Postman tool in this example and the URL is:
+Example: Using the Postman tool, the URL is:
 http://192.168.1.25:12358/configurations/config_2/sip_registration_domains/
@@ Line 77: / Line 77: @@
-If the new SIP Domain is created successfully, the following message is returned in the Postman Tool
+If the new SIP Domain is created successfully, the following message is returned:
@@ Line 88: / Line 88: @@
 PUT http://ProSBCIP:12358/configurations/configurationname/sip_registration_domains/sip_domain_name
-Example: We use the Postman tool in this example and the URL is
+Example: Using the Postman tool, the URL is
 http://192.168.1.25:12358/configurations/config_2/sip_registration_domains/TEST_DOMAIN and changed routing_method to Contact
@@ Line 95: / Line 95: @@
-If the update is successful, the following message is returned in the Postman Tool
+If the update is successful, the following message is returned:
@@ Line 101: / Line 101: @@
-Learn more about how to use RestFul API and Postman Tool from the following link [[Northbound_interface:RESTful]]
+Learn more about how to use RestFul API and Postman Tool from the following link [[Northbound_interface:RESTful]].