Аудит использования API Caila

к сведению

Чтобы получить доступ к истории запросов к API, свяжитесь со своим аккаунт-менеджером или напишите нам на support@just-ai.com.

Caila предоставляет возможность выгрузить историю запросов к API для анализа и контроля. История включает все запросы к ML-сервисам, в том числе к OpenAI adapter. Для каждого запроса хранится следующая информация:

• Источник запроса: IP-адрес, идентификатор аккаунта и пользователя.
• Данные запроса: протокол (HTTP или gRPC), путь, вызываемый ML-сервис, имя API-ключа, временная метка, размер запроса.
• Результат запроса: успех или ошибка, время обработки, размер ответа.

Выгрузка истории

Выполните запрос:

curl --location 'https://caila.io/api/mlparchive/account/{accountId}/audit?page={page}&size={size}&dateFrom={dateFrom}&dateTo={dateFrom}' \
--header 'MLP-API-KEY: {apiKey}'

Параметры запроса:

• {accountId} — идентификатор вашего аккаунта. Его можно найти на странице Аккаунты в Conversational Cloud.
• page — порядковый номер страницы для постраничной выборки, по умолчанию 0.
• size — количество записей на странице, по умолчанию 100.
• dateFrom, dateTo — начало и окончание периода в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601), например 2025-07-10T23:59:59Z.
• MLP-API-KEY — API-ключ с доступом на чтение данных в аккаунте. Управлять API-ключами можно в разделе Моё пространство → API-ключи.

Пример запроса:

curl --location 'https://caila.io/api/mlparchive/account/1010101/audit?page=0&size=100&dateFrom=2025-07-10T12%3A11%3A39.436Z&dateTo=2025-07-10T12%3A14%3A39.436Z' \
--header 'MLP-API-KEY: 1010101.0f0f0f0f0f0f0f0f0f0f0f0f'

Пример ответа:

{
    "paging": {
        "totalElements": 868,
        "totalPages": 9,
        "pageNumber": 0,
        "pageSize": 100
    },
    "records": [
        {
            "client": {
                "ipAddress": "92.55.100.77",
                "accountId": 1010101,
                "userId": 0
            },
            "request": {
                "apiClient": "HTTP",
                "path": "/api/mlpgateway/account/1010101/model/75557/predict",
                "apiTokenName": "general",
                "model": {
                    "id": model,
                    "accountId": 1022222
                },
                "requestId": "95d653d5-28dd-438c-94da-e059bf2041be",
                "timestamp": "2025-07-10T12:14:39.436Z",
                "sizeBytes": 91
            },
            "response": {
                "success": true,
                "processingTimeMs": 3377,
                "sizeBytes": 1016
            }
        }
    ]
}