Приложение 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"
    }
}