KronclAPI
Мои приложения
Введение
Публичные методы
Аккаунт
Управление
Приглашения
Отпечатки (Доступ третьим лицам)
API-ключи
GET Список
POST Создать ключ
GET Получить ключ
POST Отозвать ключ
Компании
Компания
Создать приложение
Документация API платформы. Последняя сборка v1.5.30

API-ключи / Приложения

Методы для управления API-ключами — программный доступ к платформе.

# Получение ключей

GET
/account/api-keys

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

Структура ответа

RESPONSE_DATA:
application/json
api_keysrequired
array
Ключи
Список API-ключей (ApiKeyListItem[])
paginationrequired
array
pagination

Ключ в списке

API_KEY_LIST_ITEM:
application/json
idrequired
string
ID
Уникальный идентификатор ключа
namerequired
string
Название
Название приложения
key_prefixrequired
string
Префикс
Первые символы ключа для идентификации (например: kron_abc...)
daily_requestsrequired
int
Лимит в день
Максимальное количество запросов в сутки
last_used_atoptional
string
Последнее использование
Дата последнего запроса с этим ключом (RFC 3339)
expires_atoptional
string
Истекает
Дата истечения срока действия (RFC 3339)
revoked_atoptional
string
Отозван
Дата отзыва ключа (RFC 3339)
created_atrequired
string
Создан
Дата создания (RFC 3339)

Примеры ответов

200
401
{
    "status": true,
    "message": "API keys retrieved successfully",
    "data": {
        "api_keys": [
            {
                "id": "550e8400-e29b-41d4-a716-446655440060",
                "name": "Мой бот",
                "key_prefix": "kron_abc123de",
                "daily_requests": 1000,
                "last_used_at": "2026-06-13T15:29:02Z",
                "expires_at": null,
                "revoked_at": null,
                "created_at": "2026-05-24T15:27:58Z"
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pages": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-14T00:00:00Z",
        "request_id": "...",
        "path": "/api/v1/account/api-keys",
        "method": "GET"
    }
}

# Получение ключа

GET
/account/api-keys/{keyId}

Возвращает детальную информацию об одном API-ключе. Полный ключ не возвращается — он доступен только при создании.

Структура ответа

API_KEY:
application/json
idrequired
string
ID
Уникальный идентификатор ключа
account_idrequired
string
ID аккаунта
Идентификатор владельца ключа
namerequired
string
Название
Название приложения
key_prefixrequired
string
Префикс
Первые символы ключа
daily_requestsrequired
int
Лимит в день
Максимальное количество запросов в сутки
last_used_atoptional
string
Последнее использование
Дата последнего запроса (RFC 3339)
expires_atoptional
string
Истекает
Дата истечения срока (RFC 3339)
revoked_atoptional
string
Отозван
Дата отзыва (RFC 3339)
created_atrequired
string
Создан
Дата создания (RFC 3339)
updated_atrequired
string
Обновлён
Дата последнего обновления (RFC 3339)

Примеры ответов

200
404
{
    "status": true,
    "message": "API key retrieved successfully",
    "data": {
        "id": "550e8400-e29b-41d4-a716-446655440060",
        "account_id": "550e8400-e29b-41d4-a716-446655440001",
        "name": "Мой бот",
        "key_prefix": "kron_abc123de",
        "daily_requests": 1000,
        "last_used_at": "2026-06-13T15:29:02Z",
        "expires_at": null,
        "revoked_at": null,
        "created_at": "2026-05-24T15:27:58Z",
        "updated_at": "2026-06-13T15:29:02Z"
    },
    "meta": {
        "timestamp": "2026-06-14T00:00:00Z",
        "request_id": "...",
        "path": "/api/v1/account/api-keys/...",
        "method": "GET"
    }
}

# Создание ключа

POST
/account/api-keys

Создаёт новый API-ключ. Полный ключ возвращается только один раз — сохраните его сразу.

Структура запроса

CREATE_REQUEST:
application/json
namerequired
string
Название
Название приложения (например: Мой бот)
expires_inoptional
string
Срок жизни в часах +h
24h, 48h, never (по умолчанию never)
daily_requestsoptional
int
Лимит в день
Максимальное количество запросов в сутки (по умолчанию 1000)

Структура ответа

API_KEY_WITH_RAW:
application/json
idrequired
string
ID
Уникальный идентификатор ключа
namerequired
string
Название
Название приложения
raw_keyrequired
string
Ключ
Полный ключ (показывается только один раз при создании!)
key_prefixrequired
string
Префикс
Первые символы ключа
daily_requestsrequired
int
Лимит в день
Максимальное количество запросов в сутки
expires_atoptional
string
Истекает
Дата истечения срока действия (RFC 3339)
created_atrequired
string
Создан
Дата создания (RFC 3339)

Примеры ответов

201
401
{
    "status": true,
    "message": "API key created successfully",
    "data": {
        "id": "550e8400-e29b-41d4-a716-446655440061",
        "name": "Мой бот",
        "raw_key": "kron_abc123def456ghi789jkl012mno345pq678rst",
        "key_prefix": "kron_abc123de",
        "daily_requests": 1000,
        "expires_at": null,
        "created_at": "2026-06-14T12:00:00Z"
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/account/api-keys",
        "method": "POST"
    }
}

# Отзыв ключа

POST
/account/api-keys/{keyId}/revoke

Деактивирует API-ключ. После отзыва ключ больше нельзя использовать для запросов.

Примеры ответов

200
404
{
    "status": true,
    "message": "API key revoked successfully",
    "data": {},
    "meta": {
        "timestamp": "2026-06-14T12:05:00Z",
        "request_id": "...",
        "path": "/api/v1/account/api-keys/.../revoke",
        "method": "POST"
    }
}