---
title: "Сущности"
description: "Документация по сущностям платформы Ring"
locale: "ru"
---
# API Сущностей

Управление организациями и бизнесом с **8 конечными точками** для комплексного управления сущностями, включая контроль доступа на основе ролей и отраслевые функции.

## Обзор

Сущности представляют организации, предприятия и профессиональные группы в экосистеме платформы Ring.

**Ключевые Возможности:**
- 26 типов отраслей с визуальными иконками
- Система значков верификации
- Защита конфиденциальных сущностей
- Контроль доступа на основе ролей

## Конечные Точки API

### `GET /api/entities`
Список сущностей с фильтрацией и пагинацией

### `POST /api/entities`
Создание новой сущности (требует роль MEMBER)

### `GET /api/entities/{id}`
Получение деталей сущности по ID

### `PUT /api/entities/{id}`
Обновление информации о сущности

### `DELETE /api/entities/{id}`
Удаление сущности (только для администраторов)

### `POST /api/entities/{id}/verify`
Запрос верификации сущности

### `GET /api/entities/{id}/members`
Список участников сущности и их ролей

### `POST /api/entities/{id}/members`
Добавление участника в сущность

## Структура сущности

{`id: string
  name: string
  description: string
  industry: IndustryType
  website?: string
  location?: string
  verified: boolean
  confidential: boolean
  createdAt: Date
  updatedAt: Date
  members: EntityMember[]
}

interface EntityMember {
  userId: string
  role: 'OWNER' | 'ADMIN' | 'MEMBER'
  joinedAt: Date
}`}

## Отрасли
Платформа Ring поддерживает **26 типов отраслей**:

- Технологии и Программное обеспечение
- Здравоохранение и Медицина
- Финансы и Банковское дело
- Образование и Обучение
- Производство и Промышленность
- Розничная торговля и Электронная коммерция
- Недвижимость и Строительство
- Медиа и Развлечения
- Транспорт и Логистика
- Энергетика и Коммунальные услуги
- Сельское хозяйство и Продовольствие
- Юридические и Профессиональные услуги
- Некоммерческие организации и Социальное воздействие
- Правительство и Государственный сектор
- Консалтинг и Бизнес-услуги
- Маркетинг и Реклама
- Дизайн и Творчество
- Спорт и Отдых
- Путешествия и Гостеприимство
- Автомобильная промышленность
- Аэрокосмическая и Оборонная промышленность
- Биотехнологии и Фармацевтика
- Экология и Устойчивое развитие
- Горнодобывающая промышленность и Ресурсы
- Телекоммуникации
- Другое

## Примеры Реализации

### Create Entity

```typescript
const response = await fetch('/api/entities', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify({
    name: 'Tech Innovators Inc',
    description: 'Leading software development company',
    industry: 'TECHNOLOGY_SOFTWARE',
    website: 'https://techinnovators.com',
    location: 'San Francisco, CA'
  })
})

const entity = await response.json()
```

### Список Сущностей с Фильтрацией

{`const response = await fetch('/api/entities?industry=TECHNOLOGY_SOFTWARE&verified=true&limit=10')
const { entities, total, hasMore } = await response.json()`}

### Получение Детальной Информации о Сущности

```typescript
const response = await fetch(`/api/entities/${entityId}`)
const entity = await response.json()

if (entity.confidential && !hasConfidentialAccess) {
  // Handle confidential entity access
}
```

## Контроль Доступа

### Видимость Сущностей
- **Публичные Сущности**: Видны всем пользователям
- **Конфиденциальные Сущности**: Требуют роль CONFIDENTIAL или выше

### Управление Сущностями
- **Создание**: Требует роль MEMBER
- **Обновление**: Участники сущности и участники с ролью ADMIN
- **Удаление**: Только участники с ролью ADMIN
- **Верификация**: Специальный процесс верификации

### Роли Участников
- **ВЛАДЕЛЕЦ**: Полный контроль над сущностью
- **АДМИНИСТРАТОР**: Управление участниками и контентом
- **УЧАСТНИК**: Базовый доступ к сущности

## Процесс Верификации

Сущности могут запросить значки верификации:

1. Подача заявки на верификацию
2. Предоставление необходимой документации
3. Процесс проверки платформой
4. Присвоение значка верификации

**Преимущества Верификации:**
- Повышенная достоверность
- Приоритет в результатах поиска
- Доступ к премиум функциям
- Создание конфиденциальных сущностей

---

*Готовы создать свою первую сущность? Ознакомьтесь с нашим руководством [Начало работы](/ru/docs/getting-started).*