Обробіть відхилену витрату

Slen перевіряє виклик моделі у флоу за лімітами, які ви задали: за бюджетами проєкту й за кредитами ваших клієнтів. Коли один із них каже «ні», виклик відхиляється до звернення до провайдера. Ця сторінка — про те, як перехопити таку відмову і що з нею робити.

Родина відхиленої витрати

На таку відмову відповідають статусом 402. Обидва SDK кидають такі відмови як одну родину помилок: SpendRefusedException у PHP і SpendRefusedError у Node.js, і кожен код має свій тип, який розширює тип родини. 402 із кодом, для якого SDK не має типу, кидається як сам тип родини.

Політика, яка відмовляє, до родини не входить. На policy_denied і model_not_allowed відповідають 403 і кидають їх як PolicyDeniedException або PolicyDeniedError — як перевіряється політика, каже стаття Політики. Запит для заблокованого клієнта відхиляється так само, з customer_blocked, як CustomerBlockedException або CustomerBlockedError, які розширюють тип відмови політики.

Два коди родини, overrun_stopped і overrun_approval_required, приходять від політики перевитрати вузла моделі у флоу, а така політика практично не спрацьовує — чому, кажуть їхні рядки в таблиці вище.

Перехопити її

use Slen\Sdk\Exceptions\OperationUncertainException;
use Slen\Sdk\Exceptions\SlenException;
use Slen\Sdk\Exceptions\SpendRefusedException;
use Slen\Sdk\Modules\Operations\Options\ExecuteOptions;

$input = ['messages' => [['role' => 'user', 'content' => 'Write a short follow-up email.']]];

try {
    $execution = $slen->operations()->execute('generate_email', $input, new ExecuteOptions(idempotencyKey: 'order-42:email'));

    echo $execution->status->value, PHP_EOL;
} catch (SpendRefusedException $error) {
    // The spend was refused, and the code says what refused it.
    echo 'refused: ', $error->errorCode, PHP_EOL;
} catch (OperationUncertainException $error) {
    // A provider was called and its answer was lost: the call may have been paid for.
    echo 'uncertain, request ', $error->requestId, PHP_EOL;
} catch (SlenException $error) {
    echo $error->statusCode, ' ', $error->errorCode, ': ', $error->getMessage(), PHP_EOL;
}

Код каже, який ліміт відхилив виклик, а таблиця вище — що робити з кожним.

• Відхилений виклик нічого не коштував: його провайдер не викликався, і за нього не лишається зарезервованих грошей. У флоу виклики моделей у вузлах до нього оплачено.

• Той самий запит відхиляється знову, поки щось не зміниться: бюджет почне наступне вікно, ліміт піднімуть, клієнта поповнять. Виняток — concurrency_limit_exceeded: він проходить, щойно виклик, що триває, закінчиться.

• Не надсилайте відхилений запит знову в циклі.

Друга форма: виконання, яке закінчилося відмовою

На запуск відповідають помилкою один раз. Виконання, яке він відкрив, закривається зі статусом rejected і зберігає код. Його cost.estimated — оцінка відхиленого виклику, тобто витрата, якій відмова запобігла, а не витрачені гроші, — або null, коли відмова не назвала оцінки, як для клієнта без кредитів. Той, хто читає його пізніше, отримує виконання, а не помилку: повтор запиту під його ключем, очікування, читання статусу, запуск, надісланий в асинхронному режимі. Тому запуск, який ви надсилаєте знову після відмови, іде під новим ключем.

$again = $slen->operations()->execute('generate_email', $input, new ExecuteOptions(idempotencyKey: 'order-42:email'));

if ($again->isRejected()) {
    echo 'rejected: ', $again->errorCode, PHP_EOL;
}

Коли вузол моделі має гілку на порті Відмова, відмова не закінчує виконання. Флоу продовжує шлях цією гілкою й вирішує, що почує той, хто викликає.

Вузол Відхилити запит може закінчити виконання з будь-яким кодом, зокрема з кодом цієї родини, і тоді помилка теж не кидається. Код, який реагує на відмову, обробляє обидві форми: catch і статус того, що повернулося.

Де ліміти

• Бюджети проєкту — на сторінці Бюджети.

• Кредити ваших клієнтів — на сторінці Клієнти, а поповнює їх ваш застосунок через customers.topUp() — Клієнти та кредити.

• Політики — на сторінці Політики, у розділі Налаштування.

Що читати далі

• Обробка помилок — кожна помилка SDK і чи коштувала вона грошей.

• Коди помилок — що означає кожен код і що з ним робити.

• Асинхронні запуски й очікування — як прочитати, чим закінчилося виконання.