PHP SDK

composer require rsflowhub/rsflowhub-php

RSFLOWHUB_API_KEY=rfh_your_api_key

<?php

require 'vendor/autoload.php';

use RSFlowHub\RSFlowHub;

$client = new RSFlowHub();   // reads RSFLOWHUB_API_KEY

$res = $client->ai->sentimentAnalysis([
    'text' => 'Setup took two minutes and support answered right away.',
]);

echo $res->result('sentiment');    // "positive"
print_r($res->result());           // the whole AI output
echo $res->requestId;              // "req_..." quote it when you contact support

// The method name is the endpoint slug in camelCase
$client->ai->translation(['text' => 'Hello', 'target_language' => 'French']);
$client->ai->piiRedaction(['text' => 'Call me on 555-0100']);
$client->ai->ticketAnalyze(['ticket' => 'My order never arrived']);

// An AI API released after you installed the SDK works the same way
$client->ai->brandNewEndpoint(['text' => '...']);

// A resource the SDK does not know yet
$client->resource('webhooks')->list();

// Any route, any method
$usage = $client->request('GET', '/account/usage', [], ['page' => 2]);

// Ids in the URL come first, then the body
$client->knowledgeBases->ask(12, ['question' => 'Refund policy?']);
$client->chatbots->getConversation(3, 'conv_abc123');

// ...or by name inside the array
$client->knowledgeBases->ask(['id' => 12, 'question' => 'Refund policy?']);

// A file value (SplFileInfo, fopen() resource, PSR-7 stream) makes it an upload
$client->knowledgeBases->createDocument(12, [
    'file'     => new SplFileInfo(__DIR__ . '/refund-policy.pdf'),
    'metadata' => ['source' => 'help-center'],   // sent as metadata[source]
]);

// 1. A knowledge base for your help center
$kb = $client->knowledgeBases->create(['name' => 'Help center']);
$kbId = $kb->result('knowledge_base.id');

// 2. Add content: a document, or a single FAQ item
$client->knowledgeBases->createDocument($kbId, ['file' => new SplFileInfo('refund-policy.pdf')]);
$client->knowledgeBases->createItem($kbId, [
    'content' => 'How long do refunds take?',
    'answer'  => 'Refunds reach your card in 5 to 7 business days.',
]);

// 3. Ask questions grounded in that content
$answer = $client->knowledgeBases->ask($kbId, ['question' => 'When will I get my money back?']);
print_r($answer->result());

// A chatbot (created in the dashboard or with $client->chatbots->create([...]))
$reply = $client->chatbots->sendMessage($chatbotId, ['message' => 'Where is my order?']);
$conversationId = $reply->result('conversation_id');

use RSFlowHub\Exceptions\ApiException;
use RSFlowHub\Exceptions\ConnectionException;
use RSFlowHub\Exceptions\InsufficientCreditsException;
use RSFlowHub\Exceptions\RateLimitException;
use RSFlowHub\Exceptions\ValidationException;

try {
    $res = $client->ai->textSummarize(['text' => $article]);
} catch (ValidationException $e) {
    print_r($e->getErrors());          // ['text' => ['The text field is required.']]
} catch (InsufficientCreditsException $e) {
    echo "Need {$e->getRequiredCredits()} credits, have {$e->getAvailableCredits()}.";
} catch (RateLimitException $e) {
    sleep($e->getRetryAfter() ?? 1);   // already retried max_retries times
} catch (ApiException $e) {
    echo $e->getErrorCode(), ': ', $e->getMessage(), ' (', $e->getRequestId(), ')';
} catch (ConnectionException $e) {
    // DNS, TLS, timeout or connection refused
}

$client = new RSFlowHub('rfh_your_api_key', [
    'base_url'    => 'https://rsflowhub.com/api/v1', // or RSFLOWHUB_BASE_URL
    'timeout'     => 60,     // seconds per attempt
    'max_retries' => 2,      // for 429, 502, 503, 504 and connection errors
    'headers'     => [],     // extra headers on every request
    'http_client' => null,   // your own GuzzleHttp\ClientInterface (proxy, logging, tests)
    'live_spec'   => true,   // look up unknown non-AI methods in the live OpenAPI document
]);

$res->rateLimit();   // ['limit' => 60, 'remaining' => 59, 'reset' => null]

// config/services.php
'rsflowhub' => [
    'key'         => env('RSFLOWHUB_API_KEY'),
    'base_url'    => env('RSFLOWHUB_BASE_URL', 'https://rsflowhub.com/api/v1'),
    'timeout'     => 60,
    'max_retries' => 2,
],

use RSFlowHub\Laravel\Facades\RSFlowHub;
use RSFlowHub\RSFlowHub as Client;
use RSFlowHub\Exceptions\ValidationException;

class ReviewController extends Controller
{
    // Facade
    public function store(Request $request)
    {
        $spam = RSFlowHub::ai()->spamDetection(['text' => $request->input('review')]);

        if ($spam->result('is_spam')) {
            return back()->withErrors(['review' => 'This looks like spam.']);
        }
        // ...
    }

    // Or inject the client (it is a singleton)
    public function summary(Client $client, Product $product)
    {
        return $client->ai->reviewSummary([
            'reviews' => $product->reviews()->pluck('body')->take(50)->all(),
        ])->result();
    }
}

// app/Jobs/TriageTicket.php: run AI calls in a queued job, not in the web request
class TriageTicket implements ShouldQueue
{
    use Queueable;

    public function __construct(public Ticket $ticket) {}

    public function handle(\RSFlowHub\RSFlowHub $client): void
    {
        $analysis = $client->ai->ticketAnalyze(['ticket' => $this->ticket->body]);

        $this->ticket->update([
            'priority'   => $analysis->result('priority'),
            'department' => $analysis->result('suggested_department'),
        ]);
    }
}