API Справочник
DataSmelt Engine
Полный доступ к движку слияния данных. Подключайте свои источники, отправляйте запросы к единому слою истины и управляйте пайплайнами через RESTful интерфейс.
Аутентификация и Доступ
Все запросы к API DataSmelt должны быть аутентифицированы. Мы поддерживаем два метода: OAuth2 для пользовательских приложений и API Keys для серверных интеграций.
API Keys (Server-to-Server)
Используйте для фоновых задач, ETL-процессов и интеграций с внутренними системами. Передавайте ключ в заголовке запроса.
OAuth 2.0 (User Delegation)
Необходим для приложений, действующих от имени пользователя. Позволяет управлять правами доступа (RBAC) и сессиями.
Grant Type: authorization_code
Основные Эндпоинты
Ядро платформы разделено на три группы операций: Инжекция данных, Запросы и Управление.
Ingest (Инжекция)
Загрузка сырых данных и конфигурация коннекторов.
- POST /v1/sources/connect
- POST /v1/batch/upload
- PUT /v1/schema/mapping
Query (Запросы)
Взаимодействие с расплавленным слоем данных.
- GET /v1/query/sql
- GET /v1/query/graphql
- GET /v1/semantic/ask
Manage (Управление)
Администрирование моделей и пользователей.
- GET /v1/models/list
- DELETE /v1/keys/{id}
- POST /v1/audit/logs
Лимиты и Троттлинг
Для обеспечения стабильности платформы применяются следующие ограничения (Rate Limits) в зависимости от тарифного плана.
| Параметр | Starter | Pro | Enterprise |
|---|---|---|---|
| Запросов в минуту (RPM) | 60 | 1,000 | Безлимит |
| Макс. размер payload | 5 MB | 50 MB | 1 GB |
| Параллельные соединения | 2 | 10 | 50+ |
При превышении лимита сервер вернет код 429 Too Many Requests с заголовком Retry-After.
Коды Ошибок и Обработка
Понимание кодов ответов критично для стабильной работы интеграции.
4xx Client Error
- 400 Bad Request: Синтаксическая ошибка в SQL/JSON.
- 401 Unauthorized: Неверный API Key или истек токен.
- 403 Forbidden: Недостаточно прав на доступ к ресурсу.
- 404 Not Found: Запрошенный источник или модель не существует.
5xx Server Error
- 500 Internal Error: Непредвиденная ошибка движка (повторите запрос).
- 502 Bad Gateway: Сбой связи с внешним источником данных.
- 503 Service Unavailable: Техническое обслуживание или перегрузка.
Интерактивная песочница
Тестируйте запросы в реальном времени, просматривайте схемы ответов и генерируйте SDK для вашего языка программирования прямо в браузере.
Вопросы разработчиков
Какой формат данных используется в ответах?
Все ответы приходят в формате JSON с кодировкой UTF-8. Для бинарных данных используется multipart/form-data.
Поддерживаете ли вы Webhooks?
Да. Вы можете подписаться на события `ingest.completed`, `model.updated` и `query.cache_hit` через настройки вашего API ключа в дашборде.
Как долго хранятся логи запросов?
Логи доступны через эндпоинт /audit в течение 30 дней для тарифа Pro и 90 дней для Enterprise.