> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spellit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Получение CRM данных по ID item_set

> Получение CRM данных, связанных с указанным item_set

<Callout emoji="📊">Возвращает CRM данные, связанные с указанным item\_set.</Callout>

## Параметры

* `item_set_id` (int, path, **обязательный**) - ID item\_set

## Примеры запросов

### Пример 1: Базовый запрос CRM данных

```bash theme={null}
curl -X GET "https://api.spellit.ai/api/client/item-set/123/crm-data" \
  -H "API-Access-Key: your access key"
```

### Пример 2: Запрос с дополнительными заголовками

```bash theme={null}
curl -X GET "https://api.spellit.ai/api/client/item-set/123/crm-data" \
  -H "API-Access-Key: your access key" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"
```

## Возможные ошибки

* `401 Unauthorized` - Отсутствует или неверный токен аутентификации
* `403 Forbidden` - Item\_set не принадлежит текущему пользователю
* `404 Not Found` - Item\_set с указанным ID не найден
* `500 Internal Server Error` - Внутренняя ошибка сервера

## Описание полей ответа

* `id_item_set` - ID item\_set, для которого запрашивались CRM данные
* `crm_data` - объект с CRM данными или `null`, если данные отсутствуют
  * Структура CRM данных зависит от настроек клиента
  * Может содержать любые поля, переданные при создании item\_set
* `created_at` - дата и время создания метаданных с CRM данными или `null`

## Примечания

* CRM данные извлекаются из `processing_parameters.extra_processing_data.crm_data`
* Если CRM данные не были переданы при создании item\_set, поле `crm_data` будет `null`
* CRM данные могут быть любыми JSON объектами, структура определяется клиентом

## Дополнительные примеры использования

### Примеры обработки ошибок:

#### Ошибка аутентификации:

```bash theme={null}
# Запрос без токена
curl -X GET "https://api.spellit.ai/api/client/item-set/123/crm-data"

# Ответ:
# HTTP/1.1 401 Unauthorized
{
  "detail": "Not authenticated"
}
```


## OpenAPI

````yaml GET /client/item-set/{item_set_id}/crm-data
openapi: 3.1.0
info:
  title: SpellIt API
  description: >-
    API для обработки Items через создание проекта, загрузку Item Set и загрузку
    Items
  version: 1.0.0
servers:
  - url: https://api.spellit.ai/api/
security: []
paths:
  /client/item-set/{item_set_id}/crm-data:
    get:
      description: Получение CRM данных, связанных с указанным item_set
      parameters:
        - name: item_set_id
          in: path
          required: true
          description: ID item_set
          schema:
            type: integer
      responses:
        '200':
          description: Успешный ответ
          content:
            application/json:
              schema:
                type: object
                properties:
                  id_item_set:
                    type: integer
                    description: ID item_set, для которого запрашивались CRM данные
                  crm_data:
                    type: object
                    nullable: true
                    description: Объект с CRM данными или null, если данные отсутствуют
                  created_at:
                    type: string
                    format: date-time
                    nullable: true
                    description: Дата и время создания метаданных с CRM данными или null
              examples:
                with_crm_data:
                  summary: Ответ с CRM данными
                  value:
                    id_item_set: 123
                    crm_data:
                      customer_id: CUST_001
                      customer_name: CUST_NAME
                      contact_person: Иван Иванов
                      phone: +7-999-123-45-67
                      email: ivan@example.com
                    created_at: '2024-01-15T10:30:00Z'
                without_crm_data:
                  summary: Ответ без CRM данных
                  value:
                    id_item_set: 123
                    crm_data: null
                    created_at: null
        '401':
          description: Unauthorized - Отсутствует или неверный токен аутентификации
          content:
            application/json:
              example:
                detail: Unauthorized
        '403':
          description: Forbidden - Item_set не принадлежит текущему пользователю
          content:
            application/json:
              example:
                detail: Forbidden
        '404':
          description: Not Found - Item_set с указанным ID не найден
          content:
            application/json:
              example:
                detail: Item set not found
        '500':
          description: Internal Server Error - Внутренняя ошибка сервера
          content:
            application/json:
              example:
                detail: Internal server error
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: API-Access-Key
      description: API-ключ для доступа к эндпоинтам
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT-токен для авторизации (Bearer Token)

````