Сотрудники
Облачный Pyrus
Безоблачный Pyrus
Методы позволяют добавлять сотрудников в вашу организацию, менять их данные в профиле и при необходимости блокировать вход в систему.
- GET/
membersПолучение всех пользователей организации - GET/
members/ {id}Получение информации о сотруднике по ID - POST/
membersДобавление пользователя в организацию - PUT/
members/ {id}Изменение данных пользователя - DELETE/
members/ {id}Блокировка пользователя
GET /members
Получение списка всех участников организации того пользователя, от чьего имени осуществляется запрос. Метод возвращает список всех пользователей организации.
GET https://api.pyrus.com/v4 /members
Тело ответа
{
"members":
[
{
"id": 123456,
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"type": "user",
"status": "😷Заболел",
"banned": false,
"position": "developer",
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"mobile_phone": "79091234567",
"phone": "71234567890",
"location": "Москва, офис на Соколе, 11 этаж, UTC+3",
"personality": "В свободное время люблю путешествовать и заниматься музыкой",
"personnel_number":"0000-000001",
"vacation_days": "2"
},
/*...*/
]
}
curl
curl -X GET \ 'https://api.pyrus.com/v4/members/' \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'
GET /members/{id}
Получение информации о сотруднике по ID. Метод возвращает пользователя с данными его профиля.
GET https://api.pyrus.com/v4 /members /{id}
Тело ответа
{
"id": 664768,
"first_name": "mna",
"last_name": "nas",
"email": "test.pyrus.account@gmail.com",
"type": "user",
"external_id": "",
"status": "😷Заболел",
"banned": true,
"fired": true,
"position": "",
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"mobile_phone": "79091234567",
"phone": "71234567890",
"location": "Москва, офис на Соколе, 11 этаж, UTC+3",
"personality": "В свободное время люблю путешествовать и заниматься музыкой",
"personnel_number": "0000-000001",
"vacation_days": "2",
"rights": 0,
"login_phone": "",
"web_session_settings": {
"life_span_hours": 8760
},
"mobile_session_settings": {},
"web_session_inactive_settings": {},
"mobile_session_inactive_settings": {},
"roles": [
1731,
21572,
5741
]
}
curl
curl -X GET \
'https://api.pyrus.com/v4/members/<MEMBER_ID>' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
-H 'Content-Type: application/json'
POST /members
Добавление пользователя. Метод возвращает пользователя-участника организации.
POST https://api.pyrus.com/v4 /members
Тело запроса
{
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"position": "developer",
"department_id": 123,
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"mobile_phone": "79091234567",
"phone": "71234567890",
"status": "😷Заболел",
"location": "офис на Соколе, 11 этаж, UTC+3",
"personality": "В свободное время люблю путешествовать и заниматься музыкой",
"personnel_number": "0000-000001",
"vacation_days": "2"
}
Тело ответа
{
"id": 123456,
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"type": "user",
"banned": false,
"position": "developer",
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"mobile_phone": "79091234567",
"phone": "71234567890",
"location": "офис на Соколе, 11 этаж, UTC+3",
"personality": "В свободное время люблю путешествовать и заниматься музыкой",
"personnel_number": "0000-000001",
"vacation_days": "2"
}
curl
curl -X POST \
'https://api.pyrus.com/v4/members/' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"position": "developer",
"department_id": 123,
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"phone_number": "+71234567890"
} '
Важно: во избежание злоупотреблений на использование метода POST/members наложены ограничения в дополнение к общим ограничениям на число вызовов API. При корректном использовании даже самые крупные организации не превысят разрешенных лимитов.
PUT /members/{id}
Изменение данных пользователя по ID. Метод возвращает пользователя с измененными данными профиля
PUT https://api.pyrus.com/v4 /members /{id}
Тело запроса
{
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"position": "developer",
"department_id": 123,
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"mobile_phone": "79091234567",
"phone": "71234567890",
"banned": false,
"status": "😷Заболел",
"location": "Москва, офис на Соколе, 11 этаж, UTC+3",
"personality": "В свободное время люблю путешествовать и заниматься музыкой",
"personnel_number": "0000-000001",
"vacation_days": "2"
}
Тело ответа
{
"id": 123456,
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"type": "user",
"banned": false,
"position": "developer",
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"mobile_phone": "79091234567",
"phone": "71234567890"
}
curl
curl -X PUT \
'https://api.pyrus.com/v4/members/<MEMBER_ID>' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"position": "developer",
"department_id": 123,
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"phone": +71234567890",
"banned": false
}'
Подсказка: параметры, которые вы не хотите менять, в запросе можно не указывать — в этом случае они сохранят свои предыдущие значения.
DELETE /members/{id}
Блокировка пользователя по ID. Метод возвращает пользователя, для которого запрещен доступ в Pyrus.
DELETE https://api.pyrus.com/v4 /members /{id}
Тело ответа
{
"id": 123456,
"first_name": "Иван",
"last_name": "Иванов",
"email": "ivan.ivanov@company.com",
"type": "user",
"banned": true,
"position": "developer",
"messenger": {
"type": "Telegram",
"nickname": "Jester"
},
"mobile_phone": "+79091234567",
"phone": "+71234567890"
}
curl
curl -X DELETE \ 'https://api.pyrus.com/v4/members/<MEMBER_ID>' \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ -H 'Content-Type: application/json'