Авторизация и регистрация
Регистрация пользователей и связанные запросы
[gt] POST /registration
Добавление пользователя.
// IN --->
{
"login": "login", //логин
"paswd": "12345", //пароль
"email" : "test@gradoservice.ru", //email
"status": 2, //правовой статус: 1 - юридическое лицо, 2 - физическое лицо
"fio": "Иванов И.И.", //ФИО физического лица или представителя юридического лица
"phone": "8432000555", //телефон физического лица, необязательный параметр
"address": "г.Казань, ул.Назарбаева, д.25, кв.125", //адрес физического лица, необязательный параметр
"fax": "8432000555", //факс физического лица, необязательный параметр
"inn": 161111111111, //ИНН физического лица, необязательный параметр
"passport": "9212 111111", //паспортные данные физического лица, необязательный параметр
"ur_fio": "ООО Градосервис", //название организации (юридического лица), необязательный параметр
"ur_address": "г.Казань, ул.Назарбаева, д.27, офис 6-12", //адрес организации (юридического лица), необязательный параметр
"ur_phone": "8432000555", //телефон организации (юридического лица), необязательный параметр
"ur_fax": "8432000555", //факс организации (юридического лица), необязательный параметр
"ur_inn": 1611111111, //ИНН организации (юридического лица), необязательный параметр
"ur_kpp": 160011111, //КПП организации (юридического лица), необязательный параметр
"bank": "Сбербанк", //наименование, реквизиты банка организации (юридического лица), необязательный параметр
"bank_kpp": 775003035, //КПП организации (юридического лица), необязательный параметр
"bank_bik": 044525225, //БИК организации (юридического лица), необязательный параметр
"bank_schet": "12345678901234567890", //номер счета в банке (юридического лица), необязательный параметр
"department_id": 1 //id организации, необязательный параметр
}
// OUT <---
{
"res": 1,
"resText": "",
"id": "6923", //id пользователя
"login": "login", //логин пользователя
"fio": "ООО Градосервис", //ФИО физического лица или название организации (юридического лица)
"uvd_department_id": "62", //id ведомства, задания которого будут отображаться в интерфейсе map3d_mcs для AРМ Губернатора
"users_site_type": "2", //принадлежность пользователя ведомству ("1") или организации ("2")
"satellites_view": "t", "t", //видимость спутников в АРМ Губернатора: "t" или "f"
"email": "kzn.alina@gmail.com", //email
"role_id": "10",
"matrix": "(-0.756602,0.653875,0.00069758),(0.21426,0.246913,0.945054),(0.617775,0.715179,-0.326914),(2.34475e+06,2.7075e+06,5.26909e+06)",
//матрица перелета для АРМ Губернатора
"department_id": "514" //id ведомства/организации
}
[gt] POST /registration/checklogin
Проверка логина на существование в системе.
Проверка доступности логина для использования.
// IN <---
{
"login":"user_test" //логин пользователя
}
// OUT --->
{
"res": 1,
"resText": "",
"check": "f" //true - логин не существует в системе, и он доступен для использования; false - логин существует в системе, и он не доступен для использования;
}
[gt] GET /registration/form
Список полей регистрационной формы.
// OUT --->
{
"res": 1,
"resText": "",
"fields": { //поля
"general": [ //общие поля
{
"values": "", //значения, которые может принимать поле
"name": "login", //английское название параметра
"rusName": "Логин", //русское название параметра
"required": "t" //обязательное поле или нет: true, false
},
{
"values": "",
"name": "paswd",
"rusName": "Пароль",
"required": "t"
},
{
"values": "",
"name": "email",
"rusName": "E-mail",
"required": "t"
},
{
"values": [
{
"value": "1",
"rusName": "Юридическое лицо"
},
{
"value": "2",
"rusName": "Физическое лицо"
}
],
"name": "status",
"rusName": "Правовой статус",
"required": "t"
}
],
"physical_person": [ //поля для физических лиц
{
"values": "",
"name": "fio",
"rusName": "ФИО",
"required": "t"
},
{
"values": "",
"name": "address",
"rusName": "Почтовый адрес",
"required": "t"
},
{
"values": "",
"name": "phone",
"rusName": "Телефон",
"required": "f"
},
{
"values": "",
"name": "fax",
"rusName": "Факс",
"required": "f"
},
{
"values": "",
"name": "inn",
"rusName": "ИНН",
"required": "f"
},
{
"values": "",
"name": "passport",
"rusName": "Паспортные данные",
"required": "f"
}
],
"legal_person": [ //поля для юридических лиц
{
"values": "",
"name": "ur_fio",
"rusName": "Полное наименование организации с указанием организационно-правовой формы",
"required": "t"
},
{
"values": "",
"name": "ur_address",
"rusName": "Почтовый адрес",
"required": "t"
},
{
"values": "",
"name": "ur_phone",
"rusName": "Телефон",
"required": "f"
},
{
"values": "",
"name": "ur_fax",
"rusName": "Факс",
"required": "f"
},
{
"values": "",
"name": "ur_inn",
"rusName": "ИНН",
"required": "f"
},
{
"values": "",
"name": "kpp",
"rusName": "КПП",
"required": "f"
},
{
"values": "",
"name": "bank",
"rusName": "Название банка",
"required": "f"
},
{
"values": "",
"name": "bank_kpp",
"rusName": "КПП банка",
"required": "f"
},
{
"values": "",
"name": "kpp",
"rusName": "КПП",
"required": "f"
},
{
"values": "",
"name": "bank_bik",
"rusName": "БИК банка",
"required": "f"
},
{
"values": "",
"name": "bank_schet",
"rusName": "Расчетный счет",
"required": "f"
}
]
},
"url": "/rest/registration" //URL для отправки полей на регистрацию
}
[A] POST /users
Служебный запрос. Упрощенная схема регистрации пользователей для тестов.
// IN --->
{
"login": "login", //логин
"paswd": "12345", //пароль
"email" : "test@gradoservice.ru", //email, необязательный параметр
"phone": "8432000555", //телефон, необязательный параметр
"ur_fio": "Иванов и КО", //название юр.лица, , необязательный параметр
"ur_address": "Казань", //адрес юр.лица, необязательный параметр
"status": 2, //правовой статус: "1" - юридическое лицо, "2" - физическое лицо, необязательный параметр
"organization_id": 1, //id организации, необязательный параметр
"role_id": 7, //id роли пользователя, необязательный параметр: "6", "7" - обычный пользователь, "10" - админ ведомства, "8" - администратор всех ведомств
"fio": "Иванов И.И." //ФИО пользователя, необязательный параметр
}
// OUT <---
{
"res": 1,
"resText": "",
"user": {
"id": "6391",
"login": "login",
"fio": "Иванов И.И.",
"uvd_department_id": "62", //id ведомства, задания которого будут отображаться в интерфейсе map3d_mcs для AРМ Губернатора
"users_site_type": "2", //принадлежность пользователя ведомству ("1") или организации ("2")
"satellites_view": "t", //видимость спутников в АРМ Губернатора: "t" или "f"
"role_id": "7", //id роли пользователя: "6", "7" - обычный пользователь, "10" - админ ведомства, "8" - администратор всех ведомств
"matrix": "(-0.756602,0.653875,0.00069758),(0.21426,0.246913,0.945054),(0.617775,0.715179,-0.326914),(2.34475e+06,2.7075e+06,5.26909e+06)",
//матрица перелета для АРМ Губернатора
"department_id": "1" //id ведомства/организации
}
}
[A] DELETE /users/:id
Удаление пользователя (логическое удаление).
// OUT <---
{
"res": 1,
"resText": ""
}
[A] DELETE /users/:id/hard
Удаление пользователя (физическое удаление для тестов).
// OUT <---
{
"res": 1,
"resText": ""
}
[t] POST /mobile/register
Запрос на регистрацию для получения PUSH-сообщений. Запрос поступает с мобильного устройства.
// IN --->
{ //уникальный адрес устройства для получения PUSH-сообщений, генерируется при установке приложения
"regId":"APA91bGmD0VObEd-KKuJ9J826c4o4VaxKL9VhvBQaecj3bY0RmrSp2aVmpsujTRPvYRDTvZDhVB9kxke4Q0pcivIM61PsPDd_Eh3k-0DUVdSSpXmgFAM4lsvxpuW1Re9dfQ2mSWMLiCr",
//полное имя приложения
"fqn":"android://ru.gs.mapmobile"
}
// OUT <---
{
"res": 1,
"resText": ""
}
[t] POST /mobile/unregister
Запрос на отмену регистрации для получения PUSH-сообщений. Запрос поступает с мобильного устройства.
// IN --->
{ //уникальный адрес устройства для получения PUSH-сообщений, генерируется при установке приложения
"regId":"APA91bGmD0VObEd-KKuJ9J826c4o4VaxKL9VhvBQaecj3bY0RmrSp2aVmpsujTRPvYRDTvZDhVB9kxke4Q0pcivIM61PsPDd_Eh3k-0DUVdSSpXmgFAM4lsvxpuW1Re9dfQ2mSWMLiCr",
//полное имя приложения
"fqn":"android://ru.gs.mapmobile"
}
// OUT <---
{
"res": 1,
"resText": ""
}
Авторизация пользователей
[gt] POST /authentication
Запрос на авторизацию.
// IN --->
{
"action": "post", //необходимо явно указать тип запроса "post" для соответствия с MapAdmin
"login": "login", //логин
"password": "password", //пароль
"rememberme": "1" //настройка сохранения параметров авторизации: "1" - сохранить, "0" - не сохранять
}
// OUT <---
{
"res": 1,
"resText": "",
"id":"6", //id пользователя
"login":"login", //логин пользователя
"fio":"ФИО", //имя пользователя
"uvd_department_id":"62", //id ведомства, задачи которого будут отображаться в интерфейсе map3d_mcs для AРМ Губернатора
"users_site_type":"2", //принадлежность пользователя ведомству ("1") или организации ("2")
"satellites_view":"t", //видимость спутников в АРМ Губернатора: "t" или "f"
"role_id":"8", //id роли пользователя
"email": "test@gmail.com", //email пользователя
"matrix":"(-0.756602,0.653875,0.00069758),(0.21426,0.246913,0.945054),(0.617775,0.715179,-0.326914),(2.34475e+06,2.7075e+06,5.26909e+06)",
//матрица перелета для АРМ Губернатора
"department_id":null, //id ведомства
"map_extent": [ //координаты положения карты: ["min lon","min lat","max lon","max lat"]
"46.0927078887718",
"53.9919087034184",
"55.2997131017069",
"56.6837870890742"
],
"token":"87e3d7ae036b752cc90bd093bbfa1634" //token
}