Гид по
Интеграции
Точность данных. Честность визуализации.
Этот документ предназначен для инженеров и разработчиков. Здесь нет маркетинга. Только протоколы подключения, структура запросов и правила безопасности для встраивания ГлифКит в ваш стек.
Шаг 1: Установка CLI
Клиентская утилита GlyphKit CLI — это основной интерфейс взаимодействия с сервером. Она обрабатывает шифрование пакетов и кеширование локальных метрик.
Поддерживаемые среды: Node.js 18+, Python 3.9+, Go 1.20+. Для остальных сред используйте бинарные сборки.
- > Проверка хэша пакета: OK
- > Версия ядра: 1.0.2-stable
- > Размер бинарника: 4.2MB
npm install @glyphkit/cli-core
# PIP
pip install glyphkit-cli
# GO
go get github.com/glyphkit/sdk
Шаг 2: Генерация ключей
Доступ к API осуществляется через пары ключей (Public/Private). Ключи привязываются к IP-адресу сервера для предотвращения перехвата.
Локальная генерация
Запустите команду glyphkit init в корневой папке проекта. Система сгенерирует файлы .glyph.env и .glyph.pub.
Правила безопасности
Никогда не коммитьте приватный ключ в Git. Публичный ключ можно использовать для верификации подписей запросов на стороне клиента.
Ротация
Ключи действительны 90 дней. CLI автоматически предложит ротацию за 7 дней до истечения срока. Принудительная ротация через команду glyphkit rotate.
Шаг 3: Первый запрос к API
Проверьте соединение с кластером, отправив тестовый пакет. Ожидаемый ответ — JSON с временной меткой и статусом узла.
Запрос (GET /v1/ping)
const response = await glyphkit.ping({
endpoint: 'https://api.glyphkit.io/v1',
timeout: 5000 // ms
});
Ответ (200 OK)
"status": "connected",
"latency": 42,
"timestamp": "2023-10-27T14:20:00Z",
"node_id": "NODE_RU-04"
}
Ссылки на документацию
Спецификация API
Полная документация по эндпоинтам, кодам ошибок и лимитам запросов (Rate Limiting).
Открыть Swagger ->Схемы данных
Описание структуры объектов. Схемы в формате JSON Schema и GraphQL.
Просмотреть схемы ->