+++
title = "Лицензирование HTTP API"
description = "HTTP API корпоративного лицензирования"
keywords = ["harvest", "http", "documentation", "api", "licensing", "enterprise"]
aliases = ["/docs/harvest/latest/http_api/licensing/"]
+++

# API корпоративной лицензии

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

## Проверить наличие лицензии

> ** Примечание:** Доступно в Harvest Enterprise версии 7.4+.

`GET /api/лицензирование/проверка`

Проверяет, доступна ли действительная лицензия.

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

```http
GET /api/licensing/check
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

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

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

true
```

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

- **200** - ХОРОШО

## Принудительное обновление лицензии вручную

> ** Примечание:** Доступно в Harvest Enterprise версии 7.4+.

`POST /api/лицензирование/токен/обновить`

Вручную запросите у поставщика лицензии новый токен.

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

```http
POST /api/licensing/token/renew
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{}
```

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

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

{
  "jti":"2",
  "iss":"https://harvest.com",
  "sub":"https://play.harvest.org/"
  "lid":"1",
  "included_admins":5,
  "included_viewers":10,
  "lic_exp_warn_days":30,
  "tok_exp_warn_days":2,
  "update_days":1,
  "prod":["harvest-enterprise"],
  "company":"Harvest Labs"
}
```

Ответ представляет собой большой двоичный объект JSON, доступный для целей отладки. 
Доступные поля могут быть изменены в любое время без какого-либо предварительного уведомления.

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

- **200** - ХОРОШО
- **401** - Несанкционированный
- **403** - Доступ запрещен

## Удалить лицензию из базы данных

> ** Примечание:** Доступно в Harvest Enterprise версии 7.4+.

`DELETE /api/лицензирование/токен`

Удаляет лицензию, хранящуюся в базе данных Harvest.

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

```http
DELETE /api/licensing/token
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{"instance": "http://play.harvest.org/"}
```

Схема тела JSON:

- **экземпляр** – Корневой URL-адрес экземпляра, для которого лицензия должна быть удалена. Требуемый.

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

```http
HTTP/1.1 202 Accepted
Content-Type: application/json
Content-Length: 2

{}
```

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

- **202** - Принята, лицензия удалена или не существовала.
- **401** - Несанкционированный
- **403** - Доступ запрещен
- **422** - Необработанный объект, указано неверное имя экземпляра.
