JSON API
YateHSS/HLR, YateUCN, YateSMSC and YateUSGW all offer a JSON API for configuration. You can use this API to:
configure the general network settings
set the SS7/Diameter settings of the server (both YateHSS/HLR and YateUCN)
set the SS7/SMPP settings for YateSMSC
define service (CS,PS,EPS,IMS) and SIM profiles (YateHSS/HLR)
manage subscribers (YateHSS/HLR)
request delivery of sms (YateSMSC)
The JSON API is accessed via the management IP address associated to each server. This IP address is provisioned by the MMI (Mobile Management Interface) or set by hand.
YateMMI is the interface that allows configuring the network and the SS7 settings for all Yate-based products: YateUCN, YateHSS/HLR and YateSMSC.
Request format
he basic way of making an API requests is to use the JSON format.
A subset of requests and parameters are also accessible via a JSON REST API.
JSON format
To use it, make a HTTPS POST request with “Content-Type” header “application/json” and the “X-Authentication” header set to a pre-configured value (Mobile API Secret).
Path for requests: https: //ip_management/api.php
Requests have the following format:
| { “request”: request_name, “node”: node_name, “params”: {..} } |
Example of node_names:
“hss”
“ucn”
“sdr”
Depending on the params given you retrieve:
count of objects of a certain type
| {} — retrieve count |
In response you must look for “count” key if request is successful.
a part of the objects
| a part of the objects { “limit”: , “offset”: } |
specific objects by providing the id/name/other filtering criteria
| { “name”: / “object_id”: /.. } — retrieve specific object by id/name/.. |
REST format
An alternative method supporting just a limited set of parameters is to use JSON REST API requests.
To use it make a GET or POST request to the same path to api.php and provide the “X-Authentication” header if required.
For GET parameters need to be part of the ULR like: api.php?request=REQ_NAME&node=NODE¶m=VALUE&…
For PUT the body should contain the parameters in MIME type application/x-www-form-urlencoded
Note that responses will still be in JSON format.
REST mapping
The REST access methods internally map the parameters to a JSON structure according to the following rules:
request and node are mapped as properties of the root object
All other parameters are mapped as properties
- Of the “params” object if the name contains no slash “/” character
- Of an object inside “params” whose name is obtained by replacing slashes with dots
Type conversions
- Value null is converted to a null object
- Values true and false are converted to a boolean value
- Values representing integers are converted to a numeric value
Arrays, repeated parameters or different conversions are not supported, you will need the JSON API for that.
Example:
| REST: http: //…/api.php?request=query_stats&node=hss&details=true JSON: {“request”:”query_stats”,”node”:”hss”,”params”:{“details”:true}} |
It is also possible to set request and optionally node as path parameters like this:
| http: //…/api.php/query_stats?node=hss&details=true or even http: //…/api.php/query_stats/hss?details=true |
Response format
The API always returns a JSON object with the “Content-Type” set to “application/json” or “text/x-json”.
In case of success:
| { “code”: 0 } { “code”: 0, “object_name”: [ {}, {} ] } // array of objects of the specific type. Ex: subscriber, pdn { “code”: 0, “count”: } // count of objects of specific type when no parameters were specified |
In case of an error:
| { “code”: !0, “message”: … } |
Error codes
There are two types of errors, as seen below.
HTTP errors
405 (Method not allowed) – You didn’t use HTTP POST method
415 (Unsupported Media Type/Unparsable JSON content) – Content type is not “application/json” or “text/x-json” or JSON could not be decoded
500 (Internal server error) – This could be a server configuration issue or you have multiple nodes installed on that machine and you didn’t specify ‘node’ in your request.
Errors in the JSON response
Error code:
| Category (fatal/retry) | Code | Description | Example |
| Retry once | 200 | Request not handled | Request ‘no_such’ not handled by Yate |
| Retry once | 201 | Configuration error | No node plugin is installed |
| Retry | 300 | Generic error | |
| Fatal | 400 | Generic error | |
| Fatal / needs correction | 401 | Invalid parameter(s) value | Invalid ‘port’ value ‘-3’: out of range |
| Fatal / needs correction | 402 | Missing mandatory parameter(s) | Missing ‘port’ parameter |
| Fatal / needs correction | 403 | Duplicate entity | MSISDN is already in use |
| Fatal / needs correction | 404 | Entity not found | No such operator |
| Fatal / needs correction | 405 | Entity in use | Profile still in use |
| Fatal / needs maintenance | 500 | Incompatibility | Expecting application version ‘1.3-2’ |
| Fatal / needs maintenance | 501 | File system error | Failed to save file ‘/usr/local/etc/accfile.conf’ |
| Fatal / needs maintenance | 502 | Database query execution error | Database error |
Common requests
Several requests are supposed to be handled by all node types. The properties in the returned JSON object may differ though.
Request: set_ss7_node
This request is used to configure the SS7 settings for various equipment (ex: YateHSS/HLR,YateSMSC, YateUCN etc.).
Requests
{
"request": "set_ss7_node",
"node": "The node for which SS7 settings are configured. Ex: hss",
"params": {
"comment__local": "Information about the local node (the actual equipment that you are configuring). . The information about the local node is organized in 'common' object (common settings for the network, but also equipment specific information).",
"local": {
"common": {
"dialect": "ITU/ANSI",
"netindicator": "national/reservednational/international",
"pointcode": "Local pointcode, integer representation, range depends on dialect.",
"gt": "Array of local GT. The first element is the GT we are sending from.",
"hlr": "Optional, HLR number (GT) returned in Update Location.",
"msisdn": "Array of MSISDN prefixes to which the HLR will respond.",
"ip": "Local IP address for signaling protocols. Array or comma separated list.",
"sccp_tt": "Boolean. Optional, use Translation Type in SCCP messages, defaults to false.",
"sccp_pc": "Boolean. Optional, use Point Code in SCCP source address, defaults to false."
}
},
"comment__linksets": "Configures the linksets and links to the STP",
"linksets": [
{
"type": "M2PA/M3UA",
"comment__type": "For M3UA pointcode is optional. Either pointcode and/or route must be present",
"pointcode": "Adjacent point code, integer representation, range depends on dialect",
"route": "Optional array of PCs in integer representation to route through this STP. The string 'default' may be used as point code to indicate a default route. E.g. route: [23, 'default']",
"comment__links": "M2PA: list of links. M3UA: 1 entry with connection data",
"links": [
{
"ip": "Remote IP address. Array or comma separated list.",
"port": "Integer: 1-65535. Port on the adjacent node.",
"local_ip": "Array of Optional local IP address (use common if missing).",
"local_port": "Optional. Integer: 1-65535. Local port number. Ignored for M3UA. Otherwise: use remote port as default if missing.",
"dscp": "Optional socket DSCP (string or integer)",
"comment__sctp_params": "Optional SCTP params. All params are optional. All integer params are unsigned. See lksctp.conf for info.",
"sctp_params": {
"rto_initial": "Initial Retransmission Timeout. Format: NNN. Numeric value, maximum 3 digits.",
"rto_min": "Minimum Retransmission Timeout. Format: NNN. Numeric value, maximum 3 digits.",
"rto_max": "Maximum Retransmission Timeout. Format: NNN. Numeric value, maximum 3 digits.",
"max_retrans": "Maximum number of retransmissions. Format: NNN. Numeric value, maximum 3 digits.",
"hb_interval": "Heartbeat interval in milliseconds. Defaults to 30000 for Diameter transport.",
"hb_enabled": "Boolean. Enable Heartbeat. Defaults to true.",
"sack_delay": "Selective Acknowledgement delay. Between 0 and 500ms. Format: NNN. Numeric value, maximum 3 digits.",
"sack_freq": "Selective Acknowledgement frequency. Format: NNN. Numeric value, maximum 3 digits."
}
}
],
"aspid": "M3UA only. Number. Optional ASP identifier (unsigned 32 bit)",
"contexts": "M3UA only. Number. Optional Array of routing context numbers (unsigned 32 bit)",
"traffic": "M3UA only. String. Optional traffic type. Possible values: unused/override/loadshare/broadcast",
"network_appearance": "M3UA only. Number. Optional network appearance (unsigned 32 bit)"
}
],
"comment__gt_route": "Configures the GT routes table",
"gt_route": [
{
"pc": "Number. Remote point code (must a configured one if there is no default route)",
"prefix": "Number. List of GT prefixes to route to this PC, can be just [ '*' ]"
}
]
}
}Responses
{
"code": 0,
"ss7_node": null
}Errors
{
"code": 401,
"message": "Invalid 'linkset type' value 'M2PA'."
}
{
"code": 402,
"message": "Missing all parameters./ Missing 'linkset type' parameter."
}
{
"code": 501,
"message": "Locked config file 'conf_file_name'. / Failed to save config file 'conf_file_name'. / One or more of the config files is locked."
}Examples: set_ss7_node
Configure ss7 settings.
Request
{
"request": "set_ss7_node",
"node": "hss",
"params": {
"local": {
"common": {
"dialect": "ANSI",
"netindicator": "national",
"pointcode": 33,
"gt": [
"8820033",
"88200330"
],
"msisdn": [
"8827"
],
"ip": "192.168.168.225"
}
},
"linksets": [
{
"type": "M2PA",
"pointcode": 1,
"links": [
{
"ip": "192.168.168.222",
"port": 4533,
"local_port": 4633
}
]
},
{
"type": "M2PA",
"pointcode": 101,
"links": [
{
"ip": "192.168.168.222",
"port": 4733,
"local_port": 4833
}
]
}
],
"gt_route": [
{
"pc": 1,
"prefix": [
"882",
"*"
]
},
{
"pc": 101,
"prefix": [
"40",
"*"
]
}
],
"restart": true
}
}Response
{
"code": 0,
"ss7_node": null
}Request: set_diam_node
This request is used to configure the diameter settings for various equipment (ex: YateHSS/HLR, YateUCN etc.).
Request
{
"request": "set_diam_node",
"node": "hss",
"params": {
"comment__local": "Information about the local node (the actual equipment that you are configuring). The information about the local node is organized in 'common' object (settings for the network, but also equipment specific information).",
"local": {
"common": {
"relay_route_priority": "Number. Optional default route priority for remote nodes advertising. Relay application. Negative: disable. Defaults to 100."
}
},
"comment__identities": "Configure local nodes",
"identities": [
{
"node": "Node identity (realm(domain_name)/host(host_name)). Ex: example.com/hss.example.com",
"role": "String. Optional name of special role of this node",
"default_priority": "Number. Optional priority to use this node if no other matches. Default 0 (disabled).",
"default_realm_priority": "Number. Optional priority to use this node if only realm matches. Default 0 (disabled)."
}
],
"comment__listeners": "Configure the listeners",
"listeners": [
{
"local_ip": "Array of Local IP to bind to.",
"local_port": "Optional local port number, protocol default port will be used if missing",
"ipv6only": "Boolean. Optional. Accept IPv6 only connections. Ignored if local_ip is IPv4",
"dscp": "Optional socket DSCP (string or integer)",
"sctp_params": {
"rto_initial": "Number. Unsigned. Optional. See lksctp.conf for info.",
"rto_min": "Number. Unsigned. Optional. See lksctp.conf for info.",
"rto_max": "Number. Unsigned. Optional. See lksctp.conf for info.",
"max_retrans": "Number. Unsigned. Optional. See lksctp.conf for info.",
"hb_interval": "Number. Unsigned. Optional. See lksctp.conf for info.",
"hb_enabled": "Boolean",
"sack_delay": "Number. Unsigned. Optional. See lksctp.conf for info.",
"sack_freq": "Number. Unsigned. Optional. See lksctp.conf for info."
},
"comment_accept": "Optional, configure accept rule(s). If present and not empty it will restrict the list of local nodes. Handled by this listener. All identities will be handled by this listener if accept is empty",
"accept": [
{
"node": "Node to accept, must be a configured identity",
"accept_node": "Optional remote node(s) to accept. String: RegExp to match node(s) to accept / Array: Only remote nodes matching it will be accepted. If present and not empty only listed remote nodes will be accepted.",
"default_route": "Number. Optional default route priority for accepted connections"
}
]
}
],
"comment__connections": "Information about the local node (the actual YateHSS/HLR server that you are configuring). The information about the local node is organized in 'common' object (settings for the network, but also equipment specific information).",
"connections": [
{
"node": "Local identity. The name of a node configured in identities.",
"remote_host": "Diameter remote (peer) host name. Ex: FQDN",
"ip": "Optional Array of IP address to connect to. Remote host will be used if missing.",
"port": "Optional port to connect to. Protocol default will be used if missing",
"local_ip": "Optional Array of local IP to bind on",
"dscp": "Optional socket DSCP (string or integer)",
"comment__sctp_params": "Optional SCTP params. All params are optional. All integer params are unsigned. See lksctp.conf for info",
"sctp_params": {
"rto_initial": "Number.",
"rto_min": "Number.",
"rto_max": "Number.",
"max_retrans": "Number.",
"hb_interval": "Number.",
"hb_enabled": "Boolean",
"sack_delay": "Number.",
"sack_freq": "Number."
},
"default_route": "Number. Optional default route priority"
}
]
}
}Responses
{
"code": 0,
"diam_node": null
}Errors
{
"code": 401,
"message": "No connection or listener configured. / Invalid 'accept node' param value 'provided_value' - not configured."
}
{
"code": 402,
"message": "Missing all parameters."
}Examples: set_diam_node
Configure diameter settings.
Request
{
"request": "set_diam_node",
"node": "hss",
"params": {
"identities": [
{
"node": "epc.mnc008.mcc246.3gppnetwork.org/YateHSS.epc.mnc008.mcc246.3gppnetwork.org",
"default_priority": 0,
"default_realm_priority": 0
}
],
"listeners": [
{
"local_ip": [
"192.168.50.234"
],
"ipv6only": false,
"sctp_params": {
"hb_interval": 30000,
"hb_enabled": true,
"sack_freq": 10
}
}
],
"connections": [
{
"node": "epc.mnc008.mcc246.3gppnetwork.org/YateHSS.epc.mnc008.mcc246.3gppnetwork.org",
"local_ip": [
"192.168.50.235"
],
"ip": [
"192.168.50.236"
],
"port": null,
"remote_host": "yatebtstest.com",
"sctp_params": {
"hb_interval": 30002,
"hb_enabled": true,
"sack_freq": 10
}
},
{
"node": "epc.mnc008.mcc246.3gppnetwork.org/YateHSS.epc.mnc008.mcc246.3gppnetwork.org",
"local_ip": [
"192.168.50.237"
],
"ip": [
"192.168.50.238"
],
"port": null,
"remote_host": "yatebts2.com",
"sctp_params": {
"hb_interval": 30000,
"hb_enabled": true,
"sack_freq": 10
}
},
{
"node": "epc.mnc008.mcc246.3gppnetwork.org/YateHSS.epc.mnc008.mcc246.3gppnetwork.org",
"local_ip": [
"192.168.50.221"
],
"ip": [
"192.168.50.222"
],
"port": null,
"remote_host": "yatedra2.epc.mnc008.mcc246.3gppnetwork.org",
"sctp_params": {
"hb_interval": 30000,
"hb_enabled": true,
"sack_freq": 10
}
}
]
}
}Response
{
"code": 0,
"diam_node": null
}Request: set_regexroute
This request is used to configure the regexroute settings for various equipment (ex: YateHSS/HLR, YateUCN etc.).
Requests
{
"request": "set_regexroute",
"node": "ucn",
"params": {
"rules": [
{
"name": "string, optional. Name of template used for adding comments in the written file to make reading easier.",
"rules": "string, mandatory. Contains rules that are to be written for this template in regexroute. The string must be in valid Yate configuration format."
},
"..."
]
}
}Responses
{
"code": 0,
"api_version": "Version of the package containing the API. In case the API version is unavailable the returned value is 'unknown'."
}Errors
{
"code": 401,
"message": "Invalid 'rules' value - Must be an array."
}
{
"code": 402,
"message": "Missing 'rule[0].rules' parameter."
}Examples: set_regexroute
Set regexroute rules for hss.
Requests
{
"request": "set_regexroute",
"node": "hss",
"params": {
"rules": [
{
"name": "route_msrn",
"rules": "[default]\n${roaming}^80080000=sip/sip:+${roaming}@127.0.0.1;oconnection_id=gmsc\n${roaming}^80080111=sip/sip:+${roaming}@127.0.0.2;oconnection_id=gmsc\n${roaming}^80080002=sip/sip:+${roaming}@127.0.0.3;oconnection_id=gmsc"
}
]
}
}Responses
{
"code": 0,
"regexroute": "hss"
}Request: set_javascript
This request is used to configure the javascript scripts for various equipment (ex: YateHSS/HLR, YateUCN etc.).
Requests
{
"request": "set_javascript",
"node": "hss",
"params": {
"scripts": [
{
"name": "string, optional. Name of script used for adding comments in the written file to make reading easier.",
"rules": "string, mandatory. Contains rules that are to be written for this template in regexroute. The string must be in valid Yate configuration format.",
"script": "string, mandatory. Contains the JS script that will be written for this template in javascript. The string must be in valid Yate configuration format."
},
"..."
]
}
}Responses
{
"code": 0,
"javascript": "hss"
}Errors
{
"code": 402,
"message": "Missing 'scripts[0].script' parameter."
}
{
"code": 401,
"message": "Invalid 'scripts' value - Must be an array."
}Examples: set_javascript
Basic request, successful response
Requests
{
"request": "set_javascript",
"node": "hss",
"params": {
"scripts": [
{
"name": "test",
"script": "console.log(\"test\");"
}
]
}
}Responses
{
"code": 0,
"javascript": "hss"
}Request: get_api_version
Retrieve the version of the API
Requests
{
"request": "get_api_version"
}Responses
{
"code": 0,
"api_version": "Version of the package containing the API. In case the API version is unavailable the returned value is 'unknown'."
}Examples: get_api_version
Basic request, successful response
Requests
{
"request": "get_api_version"
}Responses
{
"code": 0,
"api_version": "1.7-1_r117.mga4"
}Request: get_oem_serial
Retrieve the OEM serial number of the machine
Requests
{
"request": "get_oem_serial"
}Responses
{
"code": 0,
"serial": "OEM serial string. In case the OEM file is present but the number is missing will return 'serial':null."
}Errors
{
"code": 404,
"message": "File not found: /etc/sysconfig/oem"
}
{
"code": 501,
"message": "Cannot open for reading: /etc/sysconfig/oem"
}Examples: get_oem_serial
Basic request, successful response
Requests
{
"request": "get_oem_serial"
}Responses
{
"code": 0,
"serial": "yate-XXXXXXXX"
}Request: get_host_name
Retrieves the name of the host as configured locally.
Requests
{
"request": "get_host_name"
}Responses
{
"code": 0,
"hostname": "Name of the host as configured"
}Errors
{
"code": 501,
"mesage": "Cannot retrieve host name"
}Examples: get_host_name
Example for unconfigured node.
Requests
{
"request": "get_host_name"
}Responses
{
"code": 0,
"hostname": "localhost"
}Request: get_net_address
Retrieves a list of network interface information from the equipment.
Requests
{
"request": "get_net_address",
"params": {
"filtered": "Boolean. If true removes loopback and PGW tunnels created by Yate. (optional, default true)."
}
}Responses
{
"code": 0,
"net_address": [
{
"interface": "Name of the interface #1",
"ethernet": "Ethernet MAC address, only if applicable",
"vlan": "Numeric VLAN ID, only if applicable",
"mtu": "Numeric Maximum Transfer Unit of the interface",
"ipv4": [
{
"address": "IPv4 address #1",
"netmask": "Mask of subnet #1",
"alias": "Name of this alias, only if applicable"
},
{
"address": "IPv4 address #2",
"netmask": "Mask of subnet #2"
},
"..."
],
"ipv6": [
{
"address": "IPv6 address #1",
"prefixlen": "Numeric IPv6 network prefix length, usually 64"
},
{
"address": "IPv6 address #2",
"prefixlen": "IPv6 prefix length #2"
},
"..."
]
}
]
}Errors
{
"code": 501,
"mesage": "Cannot retrieve network interfaces"
}Examples: get_net_address
Example containing also loopback.
Requests
{
"request": "get_net_address",
"filtered": false
}Responses
{
"code": 0,
"net_address": [
{
"interface": "eth0",
"ethernet": "08:00:27:66:F9:63",
"ipv4": [
{
"address": "192.168.168.225",
"netmask": "255.255.255.0"
},
{
"address": "192.168.168.103",
"netmask": "255.255.255.0",
"alias": "0"
},
{
"address": "192.168.168.101",
"netmask": "255.255.255.0",
"alias": "1"
},
{
"address": "192.168.168.102",
"netmask": "255.255.255.0",
"alias": "2"
}
],
"ipv6": [
{
"address": "fd01::2:225",
"prefixlen": 64
},
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
},
{
"address": "fd01::1:225",
"prefixlen": 64
},
{
"address": "fd01::100",
"prefixlen": 64
},
{
"address": "fd01::101",
"prefixlen": 64
},
{
"address": "fd01::102",
"prefixlen": 64
},
{
"address": "fd01::225",
"prefixlen": 64
},
{
"address": "fd01::3:225",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.6",
"ethernet": "08:00:27:66:F9:63",
"vlan": 6,
"ipv6": [
{
"address": "2a02:2a00:5600:200::225",
"prefixlen": 64
},
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.9",
"ethernet": "08:00:27:66:F9:63",
"vlan": 9,
"ipv4": [
{
"address": "192.168.0.2",
"netmask": "255.255.255.0"
},
{
"address": "192.168.9.2",
"netmask": "255.255.255.0",
"alias": "9"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.10",
"ethernet": "08:00:27:66:F9:63",
"vlan": 10,
"ipv4": [
{
"address": "192.168.10.2",
"netmask": "255.255.254.0"
},
{
"address": "192.168.10.225",
"netmask": "255.255.254.0",
"alias": "0"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.978",
"ethernet": "08:00:27:66:F9:63",
"vlan": 978,
"ipv4": [
{
"address": "10.111.102.129",
"netmask": "255.255.255.128"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.979",
"ethernet": "08:00:27:66:F9:63",
"vlan": 979,
"ipv4": [
{
"address": "10.111.102.1",
"netmask": "255.255.255.128"
},
{
"address": "10.112.2.47",
"netmask": "255.255.255.0",
"alias": "47"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "ipsec0",
"mtu": 1400
}
]
}Example having loopback and PGW tunnel removed from response.
Requests
{
"request": "get_net_address",
"filtered": true
}Responses
{
"code": 0,
"net_address": [
{
"interface": "eth0",
"ethernet": "08:00:27:66:F9:63",
"ipv4": [
{
"address": "192.168.168.225",
"netmask": "255.255.255.0"
},
{
"address": "192.168.168.103",
"netmask": "255.255.255.0",
"alias": "0"
},
{
"address": "192.168.168.101",
"netmask": "255.255.255.0",
"alias": "1"
},
{
"address": "192.168.168.102",
"netmask": "255.255.255.0",
"alias": "2"
}
],
"ipv6": [
{
"address": "fd01::2:225",
"prefixlen": 64
},
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
},
{
"address": "fd01::1:225",
"prefixlen": 64
},
{
"address": "fd01::100",
"prefixlen": 64
},
{
"address": "fd01::101",
"prefixlen": 64
},
{
"address": "fd01::102",
"prefixlen": 64
},
{
"address": "fd01::225",
"prefixlen": 64
},
{
"address": "fd01::3:225",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.6",
"ethernet": "08:00:27:66:F9:63",
"vlan": 6,
"ipv6": [
{
"address": "2a02:2a00:5600:200::225",
"prefixlen": 64
},
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.9",
"ethernet": "08:00:27:66:F9:63",
"vlan": 9,
"ipv4": [
{
"address": "192.168.0.2",
"netmask": "255.255.255.0"
},
{
"address": "192.168.9.2",
"netmask": "255.255.255.0",
"alias": "9"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.10",
"ethernet": "08:00:27:66:F9:63",
"vlan": 10,
"ipv4": [
{
"address": "192.168.10.2",
"netmask": "255.255.254.0"
},
{
"address": "192.168.10.225",
"netmask": "255.255.254.0",
"alias": "0"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.978",
"ethernet": "08:00:27:66:F9:63",
"vlan": 978,
"ipv4": [
{
"address": "10.111.102.129",
"netmask": "255.255.255.128"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "eth0.979",
"ethernet": "08:00:27:66:F9:63",
"vlan": 979,
"ipv4": [
{
"address": "10.111.102.1",
"netmask": "255.255.255.128"
},
{
"address": "10.112.2.47",
"netmask": "255.255.255.0",
"alias": "47"
}
],
"ipv6": [
{
"address": "fe80::a00:27ff:fe66:f963",
"prefixlen": 64
}
],
"mtu": 1500
},
{
"interface": "ipsec0",
"mtu": 1400
}
]
}Request: get_node_type
Get a list of all installed node types with their versions
Requests
{
"request": "get_node_type"
}Responses
{
"code": 0,
"node_type": [
{
"type": "Type of node #1",
"version\"": "Version of node #1 or \"unknown\""
},
{
"type": "Type of node #2",
"version\"": "Version of node #2 or \"unknown\""
},
"..."
]
}Errors
{
"code": 201,
"message": "No node plugin is installed."
}Examples: get_node_type
Retrieve installed node type and software version.
Requests
{
"request": "get_node_type"
}Responses
{
"code": 0,
"node_type": [
{
"type": "mgmt",
"version": "1.2-1_r2604.mga5"
},
{
"type": "ucn",
"version": "1.1-1_r3258_r3225.mga5"
},
{
"type": "hss",
"version": "1.6-1_r3246_r3225.mga5"
},
{
"type": "dra",
"version": "1.1-1_r3101_r3225.mga5"
}
]
}Request: get_node_status
Retrieves operational status and software version of the node.
Requests
{
"request": "get_node_status",
"node": "Type of node to request status from"
}Responses
{
"code": 0,
"operational": "Boolean operational status of the node",
"level": "Symbolic reporting level for the current state",
"state": "Short description of the node state",
"service": "Longer, multiline description of the node service state"
}Errors
{
"code": 401,
"message": "Illegal node type"
}
{
"code": 401,
"message": "Unsupported node type 'NODE'."
}
{
"code": 200,
"message": "Cannot connect to Yate on port 'NNNN'.",
"version": "yate-package-version"
}Examples: get_node_status
Retrieve filtered logs for hss of level ‘note’.
Requests
{
"request": "get_node_status",
"node": "dra"
}Responses
{
"code": 0,
"status": {
"operational": false,
"level": "MILD",
"state": "Disconnected"
},
"version": "unknown"
}Request: get_node_logs
Retrieve filtered logs of a node since the last start
Requests
{
"request": "get_node_logs",
"node": "Type of node to retrieve logs from",
"params": {
"level": "Symbolic or numeric maximum level (optional)",
"lines": "Number of lines to retrieve (optional, default 50)"
}
}Responses
{
"HTTP Content-Type": "text/plain",
"HTTP Body": "Filtered log lines of the node"
}Errors
{
"code": 401,
"message": "Illegal node type"
}
{
"code": 404,
"message": "Log file not found: /var/log/yate-NODE"
}
{
"code": 501,
"message": "Cannot retrieve logs from: /var/log/yate-NODE"
}Examples: get_node_logs
Retrieve filtered logs for hss of level ‘note’.
Requests
{
"request": "get_node_logs",
"node": "hss",
"params": {
"level": "note"
}
}Responses
{
"HTTP Content-Type": "text/plain",
"HTTP Body": "Filtered log lines of the node"
}Request: get_node_config
Retrieve a configuraion file or an archive of all config files of a node
Requests
This request has multiple formats in which it can be sent:
{
"request": "get_node_config",
"node": "Type of node to retrieve configs from"
}
{
"request": "get_node_config",
"node": "Type of node to retrieve configs from",
"params": {
"file": "Name of the config file to retrieve"
}
}Responses
Response has multiple formats depending on the sent request:
{
"HTTP Content-Type": "application/octet-stream",
"HTTP Body": "Requested config file content"
}
{
"HTTP Content-Type": "application/octet-stream",
"HTTP Body": "Archive of type tar.gz of config files in the node config directory"
}Errors
{
"code": 401,
"message": "Illegal node type"
}
{
"code": 404,
"message": "Directory not found: /etc/yate/NODE"
}
{
"code": 404,
"message": "File not found: /etc/yate/NODE/FILE"
}
{
"code": 501,
"message": "Cannot get configuration from: /etc/yate/NODE/FILE"
}Examples: get_node_config
Retrieve archive of all config files for hss.
Requests
{
"request": "get_node_config",
"node": "hss"
}Responses
{
"HTTP Content-Type": "application/octet-stream",
"HTTP Body": "Archive of type tar.gz of config files in the node config directory"
}Retrieve yate-hss.conf configuraion file for hss.
Requests
{
"request": "get_node_config",
"node": "hss",
"params": {
"file": "yate-hss.conf"
}
}Responses
{
"HTTP Content-Type": "application/octet-stream",
"HTTP Body": "Requested config file content"
}Request: node_restart
Restarts the specified node of the equipment at the Operating System service level.
Requests
{
"request": "node_restart",
"node": "Type of node to restart"
}Responses
{
"code": 0,
"restarted": "NODE"
}Errors
{
"code": 401,
"message": "Illegal node type"
}
{
"code": 501,
"message": "Could not restart node NODE"
}Examples: node_restart
Restart hss node.
Requests
{
"request": "node_restart",
"node": "hss"
}Responses
{
"code": 0,
"restarted": "hss"
}Request: node_reload
Reload the configuration of a running node
Requests
{
"request": "node_reload",
"node": "Type of node to reload"
}Responses
{
"code": 0,
"reloaded": "NODE"
}Errors
{
"code": 401,
"message": "Illegal node type"
}
{
"code": 501,
"message": "Could not reload node NODE"
}Examples: node_reload
Reload the configuration for hss node.
Requests
{
"request": "node_reload",
"node": "hss"
}Responses
{
"code": 0,
"reloaded": "hss"
}Request: query_stats
Retrieve statistics from a running node
Requests
{
"request": "query_stats",
"node": "Type of node to query"
}Responses
{
"code": 0,
"stats": {
"engine": {
"version": "Version of the Yate engine",
"revision": "Numeric code revision",
"other params...": "Each parameter with its value"
},
"uptime": {
"wall": "Number of seconds since the engine started",
"user": "Number of CPU seconds consumed in userspace code",
"kernel": "Number of CPU seconds consumed in kernel code"
},
"product specific statistics grouped by component ...": {
"param1": "Value of parameter #1",
"param2": "Value of parameter #2",
"other params...": "Each parameter with its value"
}
}
}Errors
{
"code": 401,
"message": "Illegal node type"
}
{
"code": 200,
"message": "Cannot connect to Yate on port 'NNNN'."
}Examples: query_stats
Retrieve statistics from hss node
Requests
{
"request": "query_stats",
"node": "hss"
}Responses
{
"code": 0,
"stats": {
"engine": {
"version": "6.1.1",
"revision": 2187,
"nodename": "mobile-devel5",
"runid": 1576493241,
"plugins": 6,
"inuse": 1,
"handlers": 120,
"hooks": 4,
"messages": 0,
"maxqueue": 3,
"messageage": 214,
"messagerate": 2,
"maxmsgrate": 237,
"enqueued": 174208,
"dequeued": 174208,
"dispatched": 182624,
"supervised": true,
"runattempt": 1,
"lastsignal": 0,
"threads": 21,
"workers": 1,
"mutexes": 69,
"semaphores": 14,
"acceptcalls": "accept",
"congestion": 0,
"node_version": "unknown"
},
"uptime": {
"wall": 166983,
"user": 2807,
"kernel": 19693
},
"hss_cli": {
"sims": 940,
"subscribers": 832,
"cs_total": 755,
"cs_active": 0,
"ps_total": 756,
"ps_active": 0,
"ims_total": 89,
"ims_active": 0,
"operational": "(standalone)"
},
"auc_map": {
"auth2g": 0,
"auth3g": 0,
"auth4g": 0,
"resyncs": 0,
"unknowns": 0,
"illegals": 0,
"inactives": 0,
"reports": 0
},
"hss_gtt": {
"local": 0,
"imsi": 0,
"msisdn": 0,
"stp": 0,
"back": 0,
"fail": 0
},
"auc_diam": {
"auth2g": 0,
"auth3g": 0,
"auth4g": 0,
"resyncs": 0,
"unknowns": 0,
"illegals": 0,
"inactives": 0
},
"hss_cluster": {
"nodename": "mobile-devel5",
"remote": 0,
"state": "standalone"
},
"mysqldb": {
"conns": 1,
"failed": 0
}
}
}Request: info
Retrieve a list of API requests with their description
Requests
This request has multiple formats in which it can be sent:
{
"request": "info",
"node": "Type of node to retrieve APIs from"
}
{
"request": "info"
}Responses
{
"code": 0,
"api_version": "Version of the package containing the API",
"descriptions": [
{
"name_of_request_1": "Description of request 1"
},
{
"name_of_request_2": "Description of request 2"
},
"..."
]
}Errors
{
"code": 401,
"message": "No documentation for node type 'NODE'."
}
{
"code": 401,
"message": "File format error for node 'NODE'."
}Examples: info
Retrieve common requests list, response truncated for brevity
Requests
{
"request": "info"
}Responses
{
"code": 0,
"api_info": {
"api_version": "1.7-1_r117.mga4",
"descriptions": {
"info": "Retrieve a list of API requests with their description",
"get_api_version": "Retrieve the version of the API",
"get_oem_serial": "Retrieve the OEM serial number of the machine"
}
}
}Request: info_all
Retrieve a list of API requests with their detailed description
Requests
This request has multiple formats in which it can be sent:
{
"request": "info_all",
"node": "Type of the node to retrieve the full list of APIs from"
}
{
"request": "info_all"
}Responses
{
"code": 0,
"api_info": {
"api_version": "Version of the package containing the API",
"requests": [
"Description of request version 1",
"Description of request version 2",
"..."
],
"responses": [
"Description of response version 1",
"Description of response version 2",
"..."
],
"errors": [
"Description of error version 1",
"Description of error version 2",
"..."
],
"examples": [
"Example #1",
"Example #2",
"..."
]
}
}Errors
{
"code": 401,
"message": "No documentation for node type 'NODE'."
}
{
"code": 401,
"message": "File format error for node 'NODE'."
}Examples: info_all
Retrieve list of common API requests with their detailed description
Requests
{
"request": "info_all"
}Responses
{
"code": 0,
"api_info": {
"api_version": "unknown",
"requests": [
{
"name": "get_node_type",
"description": "Get a list of all installed node types with their versions",
"requests": [
{
"request": "get_node_type"
}
],
"responses": [
{
"code": 0,
"node_type": [
{
"type": "Type of node #1",
"version\"": "Version of node #1 or \"unknown\""
},
{
"type": "Type of node #2",
"version\"": "Version of node #2 or \"unknown\""
},
"..."
]
}
],
"errors": [
{
"code": 201,
"message": "No node plugin is installed."
}
],
"examples": [
{
"description": "Retrieve installed node type and software version.",
"request": {
"request": "get_node_type"
},
"response": {
"code": 0,
"node_type": [
{
"type": "mgmt",
"version": "1.2-1_r2604.mga5"
},
{
"type": "ucn",
"version": "1.1-1_r3258_r3225.mga5"
},
{
"type": "hss",
"version": "1.6-1_r3246_r3225.mga5"
},
{
"type": "dra",
"version": "1.1-1_r3101_r3225.mga5"
}
]
}
}
]
},
{
"name": "get_node_status",
"description": "Get the operational status of a node",
"requests": [
{
"request": "get_node_status",
"node": "Type of node to request status from"
}
],
"responses": [
{
"code": 0,
"operational": "Boolean operational status of the node",
"level": "Symbolic reporting level for the current state",
"state": "Short description of the node state",
"service": "Longer, multiline description of the node service state"
}
],
"errors": [
{
"code": 401,
"message": "Illegal node type"
},
{
"code": 401,
"message": "Unsupported node type 'NODE'."
}
],
"examples": [
{
"description": "Retrieve filtered logs for hss of level 'note'.",
"request": {
"request": "get_node_status",
"node": "dra"
},
"response": {
"code": 0,
"status": {
"operational": false,
"level": "MILD",
"state": "Disconnected"
},
"version": "unknown"
}
}
]
},
"..."
]
}
}This documentation was generated on 30 May 2022