PHP

composer require renamed/sdk

<?phprequire_once 'vendor/autoload.php';use Renamed\Client;// Initialize the client$client = new Client(apiKey: getenv('RENAMED_API_KEY'));// Rename a PDF$result = $client->rename(file_get_contents('invoice.pdf'));echo $result->suggestedFilename;// -> "2024-01-15_AcmeCorp_INV-1234.pdf"// Split a multi-page PDF$job = $client->pdfSplit(    file_get_contents('documents.pdf'),    mode: 'smart');print_r($job->documents);// -> [["filename" => "...", "downloadUrl" => "..."], ...]// Extract structured data$data = $client->extract(file_get_contents('receipt.pdf'));print_r($data);// -> ["vendor" => "...", "date" => "...", "amount" => "..."]

<?phpdeclare(strict_types=1);require_once 'vendor/autoload.php';use Renamed\Client;use Renamed\Options\RenameOptions;// Initialize the client$client = new Client(apiKey: getenv('RENAMED_API_KEY'));// Read the PDF file$pdfBytes = file_get_contents('./documents/invoice.pdf');// Rename the PDF$result = $client->rename($pdfBytes);echo "Suggested filename: {$result->suggestedFilename}\n";echo "Confidence: {$result->confidence}\n";// Output:// Suggested filename: 2024-01-15_AcmeCorp_INV-1234.pdf// Confidence: 0.95// Access extracted metadataecho "Vendor: {$result->metadata['vendor']}\n";echo "Date: {$result->metadata['date']}\n";echo "Type: {$result->metadata['type']}\n";// Use custom naming instructions$customResult = $client->rename($pdfBytes, new RenameOptions(    instructions: 'Format: YYYY-MM-DD_VendorName_Amount'));echo $customResult->suggestedFilename;// -> "2024-01-15_AcmeCorp_$1250.pdf"// Rename from a URL$urlResult = $client->renameFromUrl('https://example.com/document.pdf');// Using a stream instead of loading entire file into memory$stream = fopen('./documents/large-invoice.pdf', 'rb');$streamResult = $client->rename($stream);fclose($stream);

<?phpdeclare(strict_types=1);require_once 'vendor/autoload.php';use Renamed\Client;use Renamed\Options\SplitOptions;$client = new Client(apiKey: getenv('RENAMED_API_KEY'));// Read a multi-page PDF$pdfBytes = file_get_contents('./documents/combined.pdf');// Submit the split job with smart mode (AI detects document boundaries)$job = $client->pdfSplit($pdfBytes, new SplitOptions(mode: 'smart'));echo "Job ID: {$job->jobId}\n";echo "Status: {$job->state}\n";// Option 1: Wait for completion (built-in polling)$completed = $job->waitForCompletion();// Option 2: Manual polling for progress updates// while ($job->state === 'processing') {//     echo "Progress: {$job->progress}%\n";//     sleep(1);//     $job = $client->getJob($job->jobId);// }// Process the split documentsecho "Split into " . count($completed->documents) . " documents:\n";foreach ($completed->documents as $i => $doc) {    $num = $i + 1;    $pages = implode(', ', $doc->pages);    echo "  [{$num}] {$doc->filename} (pages {$pages})\n";    // Output:    // [1] invoice_1.pdf (pages 1, 2)    // [2] invoice_2.pdf (pages 3, 4)    // Download each split document    $docBytes = $client->downloadFile($doc->downloadUrl);    // Save to output directory    $outputPath = "./output/{$doc->filename}";    if (!is_dir('./output')) {        mkdir('./output', 0755, true);    }    file_put_contents($outputPath, $docBytes);    echo "  Saved: {$outputPath}\n";}// With a timeout (in seconds)$completed = $job->waitForCompletion(timeout: 300); // 5 minutes

<?phpdeclare(strict_types=1);require_once 'vendor/autoload.php';use Renamed\Client;// Define typed classes for invoice extractionreadonly class LineItem{    public function __construct(        public string $description,        public int $quantity,        public float $unitPrice,    ) {}    public static function fromArray(array $data): self    {        return new self(            description: $data['description'],            quantity: $data['quantity'],            unitPrice: $data['unitPrice'],        );    }}readonly class Invoice{    /**     * @param LineItem[] $lineItems     */    public function __construct(        public string $invoiceNumber,        public string $vendor,        public string $date,        public array $lineItems,        public float $subtotal,        public float $tax,        public float $total,    ) {}    public static function fromArray(array $data): self    {        return new self(            invoiceNumber: $data['invoiceNumber'],            vendor: $data['vendor'],            date: $data['date'],            lineItems: array_map(                fn($item) => LineItem::fromArray($item),                $data['lineItems'] ?? []            ),            subtotal: $data['subtotal'],            tax: $data['tax'],            total: $data['total'],        );    }}// Initialize the client$client = new Client(apiKey: getenv('RENAMED_API_KEY'));// Read the PDF file$pdfBytes = file_get_contents('./documents/invoice.pdf');// Basic extraction (returns associative array)$data = $client->extract($pdfBytes);echo "Vendor: {$data['vendor']}\n";echo "Date: {$data['date']}\n";echo "Total: {$data['total']}\n";// Output:// Vendor: Acme Corp// Date: 2024-01-15// Total: 1250.00// Typed extraction: convert to a class$invoice = Invoice::fromArray($data);// Now you have typed accessecho "Invoice #{$invoice->invoiceNumber} from {$invoice->vendor}\n";echo "Line items: " . count($invoice->lineItems) . "\n";foreach ($invoice->lineItems as $item) {    $price = number_format($item->unitPrice, 2);    echo "  - {$item->description}: {$item->quantity} x ${$price}\n";}echo "Total: $" . number_format($invoice->total, 2) . "\n";// Output:// Invoice #INV-2024-1234 from Acme Corp// Line items: 2//   - Widget Pro: 5 x $199.00//   - Support Plan: 1 x $342.50// Total: $1,337.50

<?phpdeclare(strict_types=1);require_once 'vendor/autoload.php';use Renamed\Client;use Renamed\Exception\RateLimitException;use Renamed\Exception\InvalidFileException;use Renamed\Exception\AuthenticationException;use Renamed\Exception\ApiException;use Renamed\Exception\NetworkException;$client = new Client(apiKey: getenv('RENAMED_API_KEY'));try {    $pdfBytes = file_get_contents('invoice.pdf');    $result = $client->rename($pdfBytes);    echo "Renamed to: {$result->suggestedFilename}\n";} catch (RateLimitException $e) {    // Rate limited - wait and retry    echo "Rate limited. Retry after {$e->getRetryAfter()} seconds\n";    sleep($e->getRetryAfter());    // Retry the request...} catch (InvalidFileException $e) {    // File is not a valid PDF or is corrupted    echo "Invalid file: {$e->getMessage()}\n";} catch (AuthenticationException $e) {    // API key is invalid or expired    echo "Authentication failed: {$e->getMessage()}\n";} catch (ApiException $e) {    // Other API errors    echo "API Error [{$e->getCode()}]: {$e->getMessage()}\n";    if ($e->getDetails()) {        echo "Details: " . json_encode($e->getDetails()) . "\n";    }} catch (NetworkException $e) {    // Network/connection errors    echo "Network error: {$e->getMessage()}\n";} catch (\Exception $e) {    // Other errors (file I/O, etc.)    echo "Unexpected error: {$e->getMessage()}\n";}// Helper function with retry logicfunction renameWithRetry(Client $client, string $pdfBytes, int $maxRetries = 3): ?object{    $retries = 0;    while (true) {        try {            return $client->rename($pdfBytes);        } catch (RateLimitException $e) {            $retries++;            if ($retries > $maxRetries) {                throw $e;            }            $sleepTime = $e->getRetryAfter() ?? (2 ** $retries);            echo "Rate limited, retrying in {$sleepTime}s (attempt {$retries}/{$maxRetries})\n";            sleep($sleepTime);        } catch (ApiException $e) {            $retries++;            if ($retries > $maxRetries || !$e->isRetryable()) {                throw $e;            }            $sleepTime = 2 ** $retries;            echo "API error, retrying in {$sleepTime}s (attempt {$retries}/{$maxRetries})\n";            sleep($sleepTime);        }    }}