Приложение 1 – Описание поля sip-headers

Опциональный параметр, содержащий вложенные SIP заголовки и их значения. Принимается как входной параметр некоторыми методами API (при поддержке данного поля указывается в описании метода). При заполнении этих заголовков со стороны внешней системы, ВАТС после прохождения валидации переданных полей заполнит соответствующие заголовки в SIP INVITE переданными значениями. Для каждого метода в API имеется свой набор разрешенных заголовков. При передаче заголовка, который не поддерживается в данном методе либо не прошел валидацию - он будет проигнорирован ВАТС. Для гарантированного прохождения валидации при заполнении каждого параметра значениями нужно руководствоваться рекомендациями соответствующего стандарта RFC.

Формальное описание грамматики поля sip_headers:

sip_headers = { fields }
        fields = "param":"value"
        param = "sip_header/sip_header_part"
        

sip_header = string token ## Сип заголовок из стандартных заголовков сип

sip_header_part = string token ## Изменяемый раздел заголовка из стандартных
        

разделов заголовков сип

value = string ## Подставляемое значение
        string = ALPHA|DIGIT exclude ";" / "/" / "?" / ":" / "@" / "&" / "=" / "+"
        

/ "$" / ","

Примеры:

{
            "sip_headers": {
                "From/display-name": "Santa Claus",
                "Call-Info/answer-after": "0"
            }
        }