+++
title = "Отчеты API"
description = "Harvest Enterprise APIs"
keywords = ["harvest", "enterprise", "api", "reporting"]
aliases = ["/docs/harvest/latest/http_api/reporting/"]
+++

# API отчетов

Этот API позволяет вам программно взаимодействовать с функцией [Reporting]({{<< "../enterprise/reporting.md" >}}).

> Отчетность доступна только в Harvest Enterprise. Узнайте больше о [Harvest Enterprise]({{< рельеф "../enterprise" >}}).


## Отправить отчет

> Доступно только в Harvest Enterprise v7.0+.

> Эта конечная точка API является экспериментальной и может устареть в будущей версии. После амортизации будет предоставлена стратегия миграции, и конечная точка будет оставаться функциональной до следующего крупного выпуска Harvest.

`POST /api/отчеты/электронная почта`

Создайте и отправьте отчет. Этот API ожидает создания отчета перед возвратом. Мы рекомендуем вам установить тайм-аут клиента не менее чем на 60 секунд.

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

```http
POST /api/reports/email HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "id":"3",
  "useEmailsFromReport": true
}
```

### Схема тела JSON

Имя поля | Тип данных | Описание
---------- | ---- | -----------
идентификатор | строка | идентификатор отправляемого отчета. Это то же самое, что и в URL-адресе при редактировании отчета, не путать с идентификатором панели мониторинга. Требуемый.
электронные письма | строка | Список электронных писем, разделенных запятыми, на которые следует отправить отчет. Переопределяет электронные письма из отчета. Требуется, если ** использовать электронные письма Из Отчета ** отсутствует.
используйте электронные письма из отчета | логическое значение | Отправьте отчет на электронные письма, указанные в отчете. Требуется, если **email** отсутствует.

### Пример ответа

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

{"message":"Report was sent"}
```

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

Код | Описание
---- | -----------
200 | Отчет был отправлен.
400 | Неверный запрос (недопустимый json, отсутствующий тип содержимого, отсутствующие или недопустимые поля и т.д.).
401 | Ошибка аутентификации, обратитесь к [API аутентификации]({{< rel ref "../http_api/auth.md" >}}).
403 | Пользователь аутентифицирован, но не авторизован для создания отчета.
404 | Отчет не найден.
500 | Непредвиденная ошибка или неправильная конфигурация сервера. Для получения более подробной информации обратитесь к основному тексту и/или журналам сервера.
