GetDepartment (V2)

Возвращает данные подразделения организации по указанному идентификатору.

GET /V2/GetDepartment

Query Parameters:

boxId – идентификатор ящика организации.
departmentId – идентификатор подразделения организации.

Request Headers:

Authorization – данные, необходимые для авторизации.

Status Codes:

200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
404 Not Found – не найдены организация или подразделение с указанным идентификатором.
405 Method Not Allowed – используется неподходящий HTTP-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит данные подразделения, представленные структурой Department.

Примеры использования

Пример HTTP-запроса:

GET /V2/GetDepartment?boxId={{boxId}}&departmentId={{departmentId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8

Пример тела ответа:

{
    "Abbreviation": "П1",
    "Address": {
        "AddressCode": "",
        "RussianAddress": {
            "Apartment": "",
            "Block": "",
            "Building": "2",
            "City": "Дзержинский",
            "OtherInformation": "",
            "Region": "50",
            "Street": "Садовая"
        }
    },
    "DepartmentId": "b651ed54-04d8-4ca8-99b5-960fba733147",
    "IsDisabled": false,
    "Name": "Подразделение 1",
    "ParentDepartmentId": "00000000-0000-0000-0000-000000000000"
}

См. также

Инструкции:

Работа с подразделениями

Методы для работы с подразделениями:

GetDepartment (V2) — возвращает данные подразделения организации по указанному идентификатору
GetDepartment — возвращает данные подразделения организации
GetDepartments — возвращает список подразделений организации
CreateDepartment — создает подразделение организации
UpdateDepartment — изменяет данные подразделения организации
DeleteDepartment — удаляет подразделение оранизации

Устаревшие версии метода:

GetDepartment