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

Отпечатки / Доступ третьим лицам

Методы для управления fingerprint-ключами — быстрый вход без пароля.

# Получение отпечатков

GET
/account/fingerprints

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

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

RESPONSE_DATA:
application/json
fingerprintsrequired
array
Отпечатки
Список отпечатков (FingerprintListItem[])
paginationrequired
array
pagination

Отпечаток

FINGERPRINT:
application/json
idrequired
string
ID
Уникальный идентификатор отпечатка
statusrequired
enum
activeinactive
Статус
Текущий статус
masked_keyrequired
string
Маска
Маскированный ключ (например: fp_abc...xyz)
last_used_atoptional
string
Последнее использование
Дата последнего использования (RFC 3339)
expired_atoptional
string
Истекает
Дата истечения срока действия (RFC 3339)
created_atrequired
string
Создан
Дата создания (RFC 3339)

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

200
401
{
    "status": true,
    "message": "Fingerprints retrieved successfully",
    "data": {
        "fingerprints": [
            {
                "id": "550e8400-e29b-41d4-a716-446655440050",
                "status": "active",
                "masked_key": "fp_abc...xyz",
                "last_used_at": "2026-06-13T15:29:02Z",
                "expired_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/fingerprints",
        "method": "GET"
    }
}

# Создание отпечатка

POST
/account/fingerprints

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

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

CREATE_REQUEST:
application/json
expires_inoptional
string
Срок жизни в часах +h
24h, 48h, never (по умолчанию never)

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

FINGERPRINT_WITH_KEY:
application/json
idrequired
string
ID
Уникальный идентификатор отпечатка
keyrequired
string
Ключ
Полный ключ (показывается только один раз при создании!)
statusrequired
enum
activeinactive
Статус
Текущий статус
expired_atoptional
string
Истекает
Дата истечения срока действия (RFC 3339)
created_atrequired
string
Создан
Дата создания (RFC 3339)

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

201
401
{
    "status": true,
    "message": "Fingerprint created successfully",
    "data": {
        "id": "550e8400-e29b-41d4-a716-446655440051",
        "key": "fp_abc123def456ghi789jkl012mno345pq",
        "status": "active",
        "created_at": "2026-06-14T12:00:00Z",
        "expired_at": null
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/account/fingerprints",
        "method": "POST"
    }
}

# Отзыв отпечатка

POST
/account/fingerprints/{fingerprintId}/revoke

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

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

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