OmniNode | API Нейросетей для разработчиков

POST /api/check/

Описание:

Когда вы отправляете запрос через /api/send/, он ставится в очередь. Метод /api/check/ позволяет вам периодически проверять, готова ли нейросеть ответить. Вы передаете request_id, полученный ранее, и получаете текущий статус обработки.

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

Параметр	Тип	Описание
`token`	string	Ваш секретный токен приложения.
`request_id`	string	Уникальный идентификатор запроса, полученный от `/api/send/`.

Пример проверки статуса на PHP

<?php
/**
 * Пример проверки статуса запроса в OmniNode API
 */

$apiUrl = 'https://omninode.ru/api/check/';
$yourToken = 'YOUR_APP_TOKEN'; // Ваш токен
$requestId = '00000000-0000-0000-0000-000000000000'; // ID, полученный ранее

$params = [
    'token' => $yourToken,
    'request_id' => $requestId
];

// Инициализация cURL
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);

// Выполнение запроса
$exec = curl_exec($ch);
$response = json_decode($exec, true);
curl_close($ch);

// Обработка ответа
if (isset($response['request_id'])) {
    echo "Статус для ID " . $response['request_id'] . ": " . $response['status'] . "" . PHP_EOL;
    
    if ($response['status'] == 'completed') {
        echo "Ответ готов! Ожидайте WebHook или проверьте URL-Result." . PHP_EOL;
        // Вы можете добавить логику для повторной проверки через некоторое время, если статус 'waiting' или 'processing'
    } elseif ($response['status'] == 'error') {
        echo "Произошла ошибка при обработке запроса." . PHP_EOL;
    }
} else {
    echo "Ошибка запроса: Не удалось получить статус. Проверьте токен или request_id.";
}
?>

Пример использования cURL

curl -X POST https://omninode.ru/api/check/ \
  -d "token=YOUR_APP_TOKEN" \
  -d "request_id=00000000-0000-0000-0000-000000000000"

Ответ сервера

Сервер возвращает JSON с информацией о статусе вашего запроса:

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "status": "processing" 
}

Описание полей:

request_id: Идентификатор запроса, который вы передали.
status: Текущий статус обработки. Возможные значения:
- "waiting": Запрос ожидает в очереди на обработку.
- "processing": Запрос обрабатывается нейросетью.
- "completed": Запрос успешно обработан. Если настроен WebHook, результат уже отправлен.
- "error": Произошла ошибка во время обработки.

Документация