= Просмотр и резерв объекта недвижимости =
Метод используется для проведения операций просмотра и резерва. 

Для проведения операции резерва требуется загрузка 2 файлов(фотографии или сканы паспорта клиента: разворот с фотографией и пропиской). 

'''Требуется обязательная валидация полей паспортных данных на количество символов!'''

Используемый метод: '''Appeal.add_appeal_wrapper'''

== Описание основной сигнатуры вызова метода ==
||'''Название ключа''' ||'''Описание''' ||'''Тип значения''' ||'''Обязательный''' ||'''Значение по-умолчанию''' ||
||pricelist_id ||id объекта(выбранной квартиры) ||number ||Да ||Null ||
||operation_type_id ||id операции: 40 - операция просмотра, 15 - операция резерва ||number ||Да ||Null ||
||operation_data ||Данные по операции ||array ||Да ||[ ] ||
||appeal_data ||Данные по обращению ||array ||Да ||[ ] ||
||files ||Файлы прикрепленные к обращению ||array ||Да ||[ ] ||


==== Описание сигнатуры объекта  "operation_data" для операции просмотра ====
||'''Название ключа''' ||'''Описание''' ||'''Тип значения''' ||'''Обязательный''' ||'''Значение по-умолчанию''' ||
||prosm_type ||всегда 'appeal' ||string ||Да ||'appeal' ||
||view_date ||желаемая дата просмотра в формате 'dd.mm.yyyy' ('24.05.2018') ||string ||Да || ||
||view_time ||время просмотра в формате 'hh:mm' ('12:00') ||string ||Да || ||
||manager_id ||выбранный id менеджера по бронированию (из словаря доступных менеджеров) ||number ||Да ||Null ||
||email ||email клиента ||string ||Да ||'' '' ||


==== Описание сигнатуры объекта  "operation_data" для операции резерва ====
||'''Название ключа''' ||'''Описание''' ||'''Тип значения''' ||'''Обязательный''' ||'''Значение по-умолчанию''' ||
||bron_type ||всегда 'appeal' ||string ||Да ||'appeal' ||
||manager_id ||выбранный id менеджера по бронированию (из словаря доступных менеджеров) ||number ||Да ||Null ||
||email ||email клиента ||string ||Да || ||
||pay_type ||id тип оплаты:  4 - 100% оплата, 5 - рассрочка, 6 - ипотека ||string ||Да ||'' '' ||
||subagent_id ||id субагента системы ||number ||Да ||Null ||
||notice ||описание ||string ||Да || ||


==== Описание сигнатуры объекта  "appeal_data" ====
||'''Название ключа''' ||'''Описание''' ||'''Тип значения''' ||'''Обязательный''' ||'''Значение по-умолчанию''' ||
||manager_id ||выбранный id менеджера по бронированию (из словаря доступных менеджеров) ||number ||Да ||Null ||
||fam ||фамилия клиента ||string ||Да ||'' '' ||
||name ||имя клиента ||string ||Да || ||
||otch ||отчество клиента ||string ||Да ||'' '' ||
||data_rozhd ||дата рождения в формате 'dd.mm.yyyy' ('24.05.2018') ||string ||Да || ||
||mj_reg ||место жительства по регистрации ||string ||Да ||'' '' ||
||mj_fakt ||место жительства фактическое ||string ||Да || ||
||korr_addr ||корреспондентский адрес ||string ||Да ||'' '' ||
||mesto_rozhd ||место рождения ||string ||Да || ||
||grazhdanstvo ||гражданство ||string ||Да ||'' '' ||
||pol ||пол: m - мужской, f - женский ||string ||Да || ||
||pasp_seriya ||серия паспорта ||string ||Да ||'' '' ||
||pasp_num ||номер паспорта ||string ||Да || ||
||pasp_date ||дата выдачи паспорта ||string ||Да ||'' '' ||
||pasp_kod_podrazdel ||Паспорт код подразделения ||string ||Да || ||
||pasp_vidan ||Кем выдан паспорт ||string ||Да ||'' '' ||
||inn ||ИНН ||string ||Да || ||
||phone ||телефон в формате - "+7 (234) 234-23-42" ||string ||Да ||'' '' ||
||rekl_phone ||Рекламный телефон в формате - "+7 (234) 234-23-42" ||string ||Да || ||
||email ||email клиента ||string ||Да ||'' '' ||
||notice ||описание ||string ||Да || ||


==== Описание сигнатуры объекта из массива объектов "files" - [{объект1}, {объект2}] для операции резерва ====
||'''Название ключа''' ||'''Описание''' ||'''Тип значения''' ||'''Обязательный''' ||'''Значение по-умолчанию''' ||
||filename ||имя файла ||string ||Да ||'' '' ||
||b64data ||b64 файла ||string ||Да || ||


== Пример запроса - операция просмотра ==
{{{#!highlight bash
QUERY_HOST="https://spn24.ru/api/v1"
QUERY_ID="530c4636-0408-45f8-ab41-28a749a3c43e"
QUERY_METHOD="Appeal.add_appeal_wrapper"
QUERY_HEADER="Content-Type: application/json"
QUERY_HEADER_AUTH="Authorization: WWWToken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

QUERY_BODY="{
    \"id\": \"$QUERY_ID\",
    \"method\": \"$QUERY_METHOD\",
    \"jsonrpc\": \"2.0\",
    \"params\": {
        \"client_id\": \"\",
        \"pricelist_id\": 23191,
        \"operation_type_id\": 40,
        \"ext_appeal\": \"\",
        \"operation_data\": {
            \"prosm_type\": \"appeal\",
            \"view_date\": \"24.05.2018\",
            \"view_time\": \"34:53\",
            \"manager_id\": 20,
            \"email\": \"\"
        },
        \"appeal_data\": {
                \"manager_id\": 20,
                \"fam\": \"\",
                \"name\": \"Name\",
                \"otch\": \"\",
                \"data_rozhd\": '',
                \"mj_fakt\": \"\",
                \"korr_addr: \"\",
                \"mesto_rozhd\": \"\",
                \"grazhdanstvo\": 1,
                \"pol\":\"m\",
                \"pasp_seriya\": \"\",
                \"pasp_num\": \"\",
                \"pasp_date\": \"\",
                \"pasp_kod_podrazdel\": \"\",
                \"pasp_vidan\": \"\",
                \"inn\": \"\",
                \"snils\": \"\",
                \"phone\": \"+7 (235) 345-34-53\",
                \"email\": \"\",
                \"rekl_phone\": \"\",
                \"notice\":[]
    }
}"

curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST
}}}
== Пример запроса - операция резерва ==
{{{#!highlight bash
QUERY_HOST="https://someserver/path/to/api"
QUERY_ID="530c4636-0408-45f8-ab41-28a749a3c43e"
QUERY_METHOD="Appeal.add_appeal_wrapper"
QUERY_HEADER="Content-Type: application/json"
QUERY_HEADER_AUTH="Authorization: WWWToken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
QUERY_BODY="{
    \"id\": \"$QUERY_ID\",
    \"jsonrpc\": \"2.0\", 
    \"method\": \"$QUERY_METHOD\",
    \"params\": {
        \"client_id\": \"\",
        \"pricelist_id\": 23191,
        \"operation_type_id\": 15,
        \"ext_appeal\": \"\",
        \"operation_data\": {
            \"bron_type\": \"appeal\",
            \"manager_id\": 20,
            \"email\": \"\",
            \"pay_type\": \"4\",
            \"subagent_id\": 2,
            \"notice\": \"\"
        },
        \"appeal_data\":{
            \"manager_id\": 20,
            \"fam\": \"Family\",
            \"name\": \"Name\",
            \"otch\": \"Surname\",
            \"data_rozhd\": \"25.05.2018\",
            \"mj_reg\": \"23423423\",
            \"mj_fakt\": \"2323423423\",
            \"korr_addr\": \"2342342\",
            \"mesto_rozhd\": \"23423423\",
            \"grazhdanstvo\": \"1\",
            \"pol\":\"m\",
            \"pasp_seriya\": \"2423\",
            \"pasp_num\": \"234234\",
            \"pasp_date\": \"25.05.2018\",
            \"pasp_kod_podrazdel\": \"234-234\",
            \"pasp_vidan\": \"23423423423\",
            \"inn\": \"\", 
            \"snils\": \"\",
            \"phone\": \"+7 (234) 234-23-42\",
            \"email": \"\",
            \"rekl_phone\": \"\",
            \"notice\": \"\"
        },
        \"files\":[
                {
                    \"filename\": \"ff56ea62f64bc1a5ad5ff8423129d095f1c3f959.jpg\",
                    \"b64data\": \"b64datastring\",
                },
                {
                    \"filename\": \"35346434534533.png\",
                    \"b64data\": \"b64datastring\",
                }
        ]
    }     
}"
curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST
}}}