4.2.4.4. Получение списка линий, подключенных пользователям
Краткие сведения
Описание
Метод возвращает информацию о получаемым линиям пользователями, с возможностью отфильтровать по пользователю, линии или клиенту.
Запрос к серверу
Параметры URL
Поле | Тип | Описание |
---|---|---|
user_id | UUID? | ID пользователя |
client_id | UUID? | ID клинта |
counterpart_owner_id | UUID? | ID контрагента, владелец пользователя (создавший клиента) |
line_id | UUID? | ID линии поддержки |
Пример
Информация по всем линиям и пользователям
GET /v1/line/subscriptions/ HTTP/1.1 Host: push.1c-connect.com accept: application/json authorization: Basic dGVzdDp0ZXN0
Curl
curl -X GET "https://push.1c-connect.com/v1/line/subscriptions/" \ -H "accept: application/json" \ -u test:test
Информация по конкретной линии
GET /v1/line/subscriptions/?line_id=9d283236-262e-11ea-80fc-0025904f970f HTTP/1.1 Host: push.1c-connect.com accept: application/json authorization: Basic dGVzdDp0ZXN0
Curl
curl -X GET "https://push.1c-connect.com/v1/line/subscriptions/?line_id=9d283236-262e-11ea-80fc-0025904f970f" \ -H "accept: application/json" \ -u test:test
Какие пользователи конкретного клиента подключены к конкретной линии
GET /v1/line/subscriptions/?client_id=be301b86-52da-45c5-9d8b-b805953e955b&line_id=9d283236-262e-11ea-80fc-0025904f970f HTTP/1.1 Host: push.1c-connect.com accept: application/json authorization: Basic dGVzdDp0ZXN0
Curl
curl -X GET "https://push.1c-connect.com/v1/line/subscriptions/?client_id=be301b86-52da-45c5-9d8b-b805953e955b&line_id=9d283236-262e-11ea-80fc-0025904f970f" \ -H "accept: application/json" \ -u test:test
Ответ сервера
Список объектов запрашивается методом: /v1/line/subscriptions/
Данные
Поле | Тип | Описание |
---|---|---|
line_id | UUID | ID линии поддержки |
user_id | UUID | ID пользователя |
subscription_set | DateTime | Дата начала подписки |
subscription_expire_at | DateTime? | Дата окончания подписки
|
Пример
[ { "user_id": "6d4a17a7-e03a-11e0-90fa-000c2926d843", "line_id": "9d283236-262e-11ea-80fc-0025904f970f", "subscription_set": "2019-12-24T00:00:00Z", "subscription_expire_at": null }, { "user_id": "f70b30ec-5c95-4175-8729-df4f709bad10", "line_id": "9d283236-262e-11ea-80fc-0025904f970f", "subscription_set": "2022-11-28T00:00:00Z", "subscription_expire_at": null } ]
Ошибки
Код | Описание |
---|---|
400 | Запрос содержит ошибку |
401 | Пользователь не авторизован |
403 | Недостаточно прав |