+++
title = "HTTP API внешней групповой синхронизации "
description = "Сбор HTTP-API внешней групповой синхронизации"
keywords = ["harvest", "http", "documentation", "api", "team", "teams", "group", "member", "enterprise"]
aliases = ["/docs/harvest/latest/http_api/external_group_sync/"]
+++

# API внешней групповой синхронизации

> Синхронизация внешней группы доступна только в Harvest Enterprise. Узнайте больше о [Harvest Enterprise]({{< рельеф "../enterprise" >}}).

## Получить Внешние Группы

`GET /api/teams/:teamId/groups`

**Пример Запроса**:

```http
GET /api/teams/1/groups HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Basic YWRtaW46YWRtaW4=
```

**Пример Ответа**:

```http
HTTP/1.1 200
Content-Type: application/json

[
  {
    "orgId": 1,
    "teamId": 1,
    "groupId": "cn=editors,ou=groups,dc=harvest,dc=org"
  }
]
```

Коды состояния:

- **200** - Хорошо
- **401** - Несанкционированный
- **403** - В разрешении отказано

## Добавить Внешнюю Группу

`POST /api/teams/:teamId/groups`

**Пример Запроса**:

```http
POST /api/teams/1/members HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Basic YWRtaW46YWRtaW4=

{
  "groupId": "cn=editors,ou=groups,dc=harvest,dc=org"
}
```

**Пример Ответа**:

```http
HTTP/1.1 200
Content-Type: application/json

{"message":"Group added to Team"}
```

Коды состояния:

- **200** - Хорошо
- **400** - Группа уже добавлена в эту команду
- **401** - Несанкционированный
- **403** - В разрешении отказано
- **404** - Команда не найдена

## Удалить Внешнюю Группу

`DELETE /api/teams/:teamId/groups/:groupId`

**Пример Запроса**:

```http
DELETE /api/teams/1/groups/cn=editors,ou=groups,dc=harvest,dc=org HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Basic YWRtaW46YWRtaW4=
```

**Пример Ответа**:

```http
HTTP/1.1 200
Content-Type: application/json

{"message":"Team Group removed"}
```

Коды состояния:

- **200** - Хорошо
- **401** - Несанкционированный
- **403** - В разрешении отказано
- **404** - Команда не найдена/Группа не найдена
