# Коннекторы приложения

Приложение читает данные внешних сервисов через коннекторы компании. Доступ приложения к коннектору одобряет администратор портала по заявке.

## Операции

- [Список коннекторов приложения](./connectors/list.md) — `GET /v1/applications/:id/connectors`
- [Запросить доступ к коннектору](./connectors/access-request.md) — `POST /v1/applications/:id/connectors/:slug/access-request`

## Доступ

- Методы вызывает тот, кто управляет приложением, включая участников команды разработки его машины. Права совпадают с правами на [секреты приложения](/docs/applications/app-secrets).
- Для заявки на доступ нужен ключ в режиме `READWRITE`.
- Коннекторы для приложений должны быть включены для портала Битрикс24. Пока они выключены, оба метода отвечают `404 APPLICATION_NOT_FOUND`.

## Типовой сценарий

1. Получить коннекторы компании и состояние доступа приложения к каждому — [`GET /v1/applications/:id/connectors`](./connectors/list.md).
2. Отправить заявку на нужный коннектор по его коду `slug` — [`POST /v1/applications/:id/connectors/:slug/access-request`](./connectors/access-request.md).
3. Администратор портала подключает компанию к коннектору и одобряет заявку. После этого снова вызвать список и проверить `appState`.

## Смотрите также

- [Витрина приложений](/docs/applications)
- [Секреты приложения](/docs/applications/app-secrets)
