API Reference
REST и GraphQL
Программный доступ к движку калибровки Хромали. Интегрируйте проверку цветовой консистентности, генерацию ICC-профилей и аудит ассетов прямо в ваши CI/CD пайплайны и дизайн-системы.
Аутентификация
Безопасность и доступ
Все запросы к API Хромали должны быть аутентифицированы с использованием Bearer-токенов. Мы используем стандарт OAuth 2.0 для обеспечения безопасности ваших проектных данных. Токены привязаны к конкретному workspace и имеют ограниченный срок действия (TTL 3600 секунд).
Authorization: Bearer x-chr-9a8b7c6d5e4f3g2h1
Для получения токена используйте эндпоинт /auth/token, передав ваш Client ID и Client Secret в теле запроса.
Основные Эндпоинты
Платформа предоставляет гибкие методы для управления проектами, запуска аудитов и получения отчетов о точности цвета.
/v1/projects
Получение списка всех подключенных дизайн-систем и проектов. Поддерживает пагинацию и фильтрацию по статусу калибровки.
/v1/calibrate
Запуск синхронного или асинхронного процесса калибровки переданного изображения или пакета ассетов. Возвращает ID задачи.
/v1/reports/delta-e
Запрос детального отчета о цветовых отклонениях (Delta E) для конкретного артефакта по сравнению с эталоном.
Примеры запросов (GraphQL)
Гибкость данных
Для сложных сценариев мы рекомендуем использовать наш GraphQL-эндпоинт. Это позволяет запрашивать только те метрики, которые нужны вашей системе, минимизируя нагрузку на сеть.
query GetCalibrationStatus {
project(id: "proj_8821") {
name
lastAudit {
timestamp
averageDeltaE
iccProfileVersion
}
}
}
Лимиты и тарификация
Превышение лимитов приводит к коду ответа 429 Too Many Requests. Для тарифа Enterprise доступны выделенные каналы с неограниченной пропускной способностью.
Интегрируйте точность сегодня
Получите бесплатный ключ разработчика и протестируйте sandbox-среду за 5 минут.
Доступ к Sandbox