Merge pull request #199 from uploadcare/feature/api-samples

rsedykh · web-flow · commit 1472599012c8 · 2023-02-06T16:02:16.000+07:00
API samples
diff --git a/.php-cs-fixer.dist.php b/.php-cs-fixer.dist.php
@@ -9,6 +9,7 @@
     ->in([
         __DIR__ . '/src',
         __DIR__ . '/tests',
+        __DIR__ . '/api-samples',
     ]);
 
 $rules = [
diff --git a/api-samples/rest-api/delete-files-storage.php b/api-samples/rest-api/delete-files-storage.php
@@ -0,0 +1,8 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+$fileInfo = $api->fileInfo('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+$api->deleteFile($fileInfo);
+
+echo \sprintf('File \'%s\' deleted at \'%s\'', $fileInfo->getUuid(), $fileInfo->getDatetimeRemoved()->format(\DateTimeInterface::ATOM));
diff --git a/api-samples/rest-api/delete-files-uuid-metadata-key.php b/api-samples/rest-api/delete-files-uuid-metadata-key.php
@@ -0,0 +1,10 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$metadataApi = (new Uploadcare\Api($configuration))->metadata();
+try {
+    $metadataApi->removeKey('1bac376c-aa7e-4356-861b-dd2657b5bfd2', 'pet');
+} catch (\Throwable $e) {
+    echo \sprintf('Error while key removing: %s', $e->getMessage());
+}
+echo 'Key was successfully removed';
diff --git a/api-samples/rest-api/delete-files-uuid-storage.php b/api-samples/rest-api/delete-files-uuid-storage.php
@@ -0,0 +1,5 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$fileInfo = (new Uploadcare\Api($configuration))->file()->deleteFile('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+echo \sprintf('File \'%s\' deleted at \'%s\'', $fileInfo->getUuid(), $fileInfo->getDatetimeRemoved()->format(\DateTimeInterface::ATOM));
diff --git a/api-samples/rest-api/delete-groups-uuid.php b/api-samples/rest-api/delete-groups-uuid.php
@@ -0,0 +1,10 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->group();
+try {
+    $api->removeGroup('c5bec8c7-d4b6-4921-9e55-6edb027546bc~1');
+} catch (\Throwable $e) {
+    echo \sprintf('Error while group deletion: %s', $e->getMessage());
+}
+echo 'Group successfully deleted';
diff --git a/api-samples/rest-api/delete-webhooks-unsubscribe.php b/api-samples/rest-api/delete-webhooks-unsubscribe.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->webhook();
+$result = $api->deleteWebhook('https://yourwebhook.com');
+
+echo $result ? 'Webhook has been deleted' : 'Webhook is not deleted, something went wrong';
diff --git a/api-samples/rest-api/get-addons-aws_rekognition_detect_labels-execute-status.php b/api-samples/rest-api/get-addons-aws_rekognition_detect_labels-execute-status.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->addons();
+$status = $api->checkAwsRecognition('request-id');
+
+echo \sprintf('Recognition status: %s', $status);
diff --git a/api-samples/rest-api/get-addons-remove_bg-execute-status.php b/api-samples/rest-api/get-addons-remove_bg-execute-status.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->addons();
+$status = $api->checkRemoveBackground('request-id');
+
+echo \sprintf('Remove background status: %s', $status);
diff --git a/api-samples/rest-api/get-addons-uc_clamav_virus_scan-execute-status.php b/api-samples/rest-api/get-addons-uc_clamav_virus_scan-execute-status.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->addons();
+$status = $api->checkAntivirusScan('request-id');
+
+echo \sprintf('Antivirus scan status: %s', $status);
diff --git a/api-samples/rest-api/get-convert-document-status-token.php b/api-samples/rest-api/get-convert-document-status-token.php
@@ -0,0 +1,8 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->conversion();
+
+$status = $api->documentJobStatus(123456);
+
+echo \sprintf('Conversion status: %s', $status->getError() ?? $status->getStatus());
diff --git a/api-samples/rest-api/get-convert-video-status-token.php b/api-samples/rest-api/get-convert-video-status-token.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->conversion();
+$status = $api->videoJobStatus(123456);
+
+echo \sprintf('Conversion status: %s', $status->getError() ?? $status->getStatus());
diff --git a/api-samples/rest-api/get-files-uuid-metadata-key.php b/api-samples/rest-api/get-files-uuid-metadata-key.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->metadata();
+$metadata = $api->getMetadata('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+
+echo \sprintf('Value for key \'pet\' %s', $metadata['pet'] ?? 'does not exists');
diff --git a/api-samples/rest-api/get-files-uuid-metadata.php b/api-samples/rest-api/get-files-uuid-metadata.php
@@ -0,0 +1,10 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+$fileInfo = $api->fileInfo('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+
+echo \sprintf("File %s metadata:\n", $fileInfo->getUuid());
+foreach ($fileInfo->getMetadata() as $metaKey => $metaItem) {
+    echo \sprintf("%s: %s\n", $metaKey, $metaItem);
+}
diff --git a/api-samples/rest-api/get-files-uuid.php b/api-samples/rest-api/get-files-uuid.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+$fileInfo = $api->fileInfo('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+
+echo \sprintf('URL: %s, ID: %s, Mime type: %s', $fileInfo->getUrl(), $fileInfo->getUuid(), $fileInfo->getMimeType());
diff --git a/api-samples/rest-api/get-files.php b/api-samples/rest-api/get-files.php
@@ -0,0 +1,15 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+
+$list = $api->listFiles();
+foreach ($list->getResults() as $result) {
+    echo \sprintf('URL: %s', $result->getUrl());
+}
+
+while (($next = $api->nextPage($list)) !== null) {
+    foreach ($next->getResults() as $result) {
+        echo \sprintf('URL: %s', $result->getUrl());
+    }
+}
diff --git a/api-samples/rest-api/get-groups-uuid.php b/api-samples/rest-api/get-groups-uuid.php
@@ -0,0 +1,11 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->group();
+$groupInfo = $api->groupInfo('c5bec8c7-d4b6-4921-9e55-6edb027546bc~1');
+
+echo \sprintf("Group: %s files:\n", $groupInfo->getUrl());
+
+foreach ($groupInfo->getFiles() as $file) {
+    \sprintf('File: %s (%s)', $file->getUrl(), $file->getUuid());
+}
diff --git a/api-samples/rest-api/get-groups.php b/api-samples/rest-api/get-groups.php
@@ -0,0 +1,15 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->group();
+
+$list = $api->listGroups();
+foreach ($list->getResults() as $group) {
+    \sprintf('Group URL: %s, ID: %s', $group->getUrl(), $group->getUuid());
+}
+
+while (($next = $api->nextPage($list)) !== null) {
+    foreach ($next->getResults() as $group) {
+        \sprintf('Group URL: %s, ID: %s', $group->getUrl(), $group->getUuid());
+    }
+}
diff --git a/api-samples/rest-api/get-project.php b/api-samples/rest-api/get-project.php
@@ -0,0 +1,13 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->project();
+$projectInfo = $api->getProjectInfo();
+
+echo \sprintf("Project %s info:\n", $projectInfo->getName());
+echo \sprintf("Public key: %s\n", $projectInfo->getPubKey());
+echo \sprintf("Auto-store enabled: %s\n", $projectInfo->isAutostoreEnabled() ? 'yes' : 'no');
+
+foreach ($projectInfo->getCollaborators() as $email => $name) {
+    echo \sprintf("%s: %s\n", $name, $email);
+}
diff --git a/api-samples/rest-api/get-webhooks.php b/api-samples/rest-api/get-webhooks.php
@@ -0,0 +1,8 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->webhook();
+
+foreach ($api->listWebhooks() as $webhook) {
+    \sprintf("Webhook with url %s is %s\n", $webhook->getTargetUrl(), $webhook->isActive() ? 'active' : 'not active');
+}
diff --git a/api-samples/rest-api/post-addons-aws_rekognition_detect_labels-execute.php b/api-samples/rest-api/post-addons-aws_rekognition_detect_labels-execute.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->addons();
+$resultKey = $api->requestAwsRecognition('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+
+echo \sprintf('Recognition requested. Key is \'%s\'', $resultKey);
diff --git a/api-samples/rest-api/post-addons-remove_bg-execute.php b/api-samples/rest-api/post-addons-remove_bg-execute.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->addons();
+$resultKey = $api->requestRemoveBackground('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+
+echo \sprintf('Remove background requested. Key is \'%s\'', $resultKey);
diff --git a/api-samples/rest-api/post-addons-uc_clamav_virus_scan-execute.php b/api-samples/rest-api/post-addons-uc_clamav_virus_scan-execute.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->addons();
+$resultKey = $api->requestAntivirusScan('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+
+echo \sprintf('Antivirus scan requested. Key is \'%s\'', $resultKey);
diff --git a/api-samples/rest-api/post-convert-document.php b/api-samples/rest-api/post-convert-document.php
@@ -0,0 +1,18 @@
+<?php
+
+use Uploadcare\Interfaces\Conversion\ConvertedItemInterface;
+use Uploadcare\Interfaces\Response\ResponseProblemInterface;
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->conversion();
+
+$request = new Uploadcare\Conversion\DocumentConversionRequest('pdf');
+$result = $api->convertDocument('1bac376c-aa7e-4356-861b-dd2657b5bfd2', $request);
+
+if ($result instanceof ConvertedItemInterface) {
+    echo \sprintf('Conversion requested. Key is \'%s\'', $result->getToken());
+}
+
+if ($result instanceof ResponseProblemInterface) {
+    echo \sprintf('Error in request: %s', $result->getReason());
+}
diff --git a/api-samples/rest-api/post-convert-video.php b/api-samples/rest-api/post-convert-video.php
@@ -0,0 +1,23 @@
+<?php
+
+use Uploadcare\Interfaces\Conversion\ConvertedItemInterface;
+use Uploadcare\Interfaces\Response\ResponseProblemInterface;
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->conversion();
+
+$request = (new Uploadcare\Conversion\VideoEncodingRequest())
+    ->setHorizontalSize(1024)
+    ->setVerticalSize(768)
+    ->setResizeMode('preserve_ratio')
+    ->setTargetFormat('mp4');
+
+$result = $api->convertVideo('1bac376c-aa7e-4356-861b-dd2657b5bfd2', $request);
+
+if ($result instanceof ConvertedItemInterface) {
+    echo \sprintf('Conversion requested. Key is \'%s\'', $result->getToken());
+}
+
+if ($result instanceof ResponseProblemInterface) {
+    echo \sprintf('Error in request: %s', $result->getReason());
+}
diff --git a/api-samples/rest-api/post-files-local-copy.php b/api-samples/rest-api/post-files-local-copy.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+$fileInfo = $api->copyToLocalStorage('1bac376c-aa7e-4356-861b-dd2657b5bfd2', true);
+
+echo \sprintf('File \'%s\' copied to local storage', $fileInfo->getUuid());
diff --git a/api-samples/rest-api/post-files-remote-copy.php b/api-samples/rest-api/post-files-remote-copy.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+$result = $api->copyToRemoteStorage('1bac376c-aa7e-4356-861b-dd2657b5bfd2', true);
+
+echo \sprintf('File \'%s\' copied to local storage', $result);
diff --git a/api-samples/rest-api/post-webhooks.php b/api-samples/rest-api/post-webhooks.php
@@ -0,0 +1,8 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->webhook();
+
+$result = $api->createWebhook('https://yourwebhook.com', true, 'sign-secret');
+
+echo \sprintf('Webhook %s created', $result->getId());
diff --git a/api-samples/rest-api/put-files-storage.php b/api-samples/rest-api/put-files-storage.php
@@ -0,0 +1,16 @@
+<?php
+
+use Uploadcare\Interfaces\File\FileInfoInterface;
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+
+$result = $api->batchStoreFile(['b7a301d1-1bd0-473d-8d32-708dd55addc0', '1bac376c-aa7e-4356-861b-dd2657b5bfd2']);
+
+foreach ($result->getResult() as $result) {
+    if (!$result instanceof FileInfoInterface) {
+        continue;
+    }
+
+    \sprintf('Result %s is stored at %s', $result->getUuid(), $result->getDatetimeStored()->format(\DateTimeInterface::ATOM));
+}
diff --git a/api-samples/rest-api/put-files-uuid-metadata-key.php b/api-samples/rest-api/put-files-uuid-metadata-key.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->metadata();
+$result = $api->setKey('1bac376c-aa7e-4356-861b-dd2657b5bfd2', 'pet', 'dog');
+
+echo \sprintf('Metadata key \'pet\' is set to %s', $result['pet']);
diff --git a/api-samples/rest-api/put-files-uuid-storage.php b/api-samples/rest-api/put-files-uuid-storage.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->file();
+$result = $api->storeFile('1bac376c-aa7e-4356-861b-dd2657b5bfd2');
+
+echo \sprintf('File %s is stored at %s', $result->getUuid(), $result->getDatetimeStored()->format(\DateTimeInterface::ATOM));
diff --git a/api-samples/rest-api/put-webhooks-id.php b/api-samples/rest-api/put-webhooks-id.php
@@ -0,0 +1,12 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$api = (new Uploadcare\Api($configuration))->webhook();
+$webhook = $api->updateWebhook(1234, [
+    'target_url' => 'https://yourwebhook.com',
+    'event' => 'file.uploaded',
+    'is_active' => true,
+    'signing_secret' => 'webhook-secret',
+]);
+
+\sprintf("Webhook with url %s is %s\n", $webhook->getTargetUrl(), $webhook->isActive() ? 'active' : 'not active');
diff --git a/api-samples/upload-api/get-from_url-status.php b/api-samples/upload-api/get-from_url-status.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$uploader = new Uploadcare\Uploader\Uploader($configuration);
+$status = $uploader->checkStatus('945ebb27-1fd6-46c6-a859-b9893712d650');
+
+echo \sprintf('Upload status is %s', $status);
diff --git a/api-samples/upload-api/get-group-info.php b/api-samples/upload-api/get-group-info.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$uploader = new Uploadcare\Uploader\Uploader($configuration);
+$groupInfo = $uploader->groupInfo('0d712319-b970-4602-850c-bae1ced521a6~1');
+
+echo $groupInfo->getBody()->getContents();
diff --git a/api-samples/upload-api/get-info.php b/api-samples/upload-api/get-info.php
@@ -0,0 +1,7 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$uploader = new Uploadcare\Uploader\Uploader($configuration);
+$fileInfo = $uploader->fromPath(__DIR__ . '/squirrel.jpg');
+
+echo \sprintf('URL: %s, ID: %s, Mime type: %s', $fileInfo->getUrl(), $fileInfo->getUuid(), $fileInfo->getMimeType());
diff --git a/api-samples/upload-api/post-base.php b/api-samples/upload-api/post-base.php
@@ -0,0 +1,13 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$uploader = new Uploadcare\Uploader\Uploader($configuration);
+$fileInfo = $uploader->fromPath(__DIR__ . '/squirrel.jpg', null, null, '1', [
+    'system' => 'php-uploader',
+    'pet' => 'cat',
+]);
+
+echo \sprintf("URL: %s, ID: %s, Mime type: %s\n", $fileInfo->getUrl(), $fileInfo->getUuid(), $fileInfo->getMimeType());
+foreach ($fileInfo->getMetadata() as $key => $value) {
+    echo \sprintf("%s: %s\n", $key, $value);
+}
diff --git a/api-samples/upload-api/post-from_url.php b/api-samples/upload-api/post-from_url.php
@@ -0,0 +1,13 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$uploader = new Uploadcare\Uploader\Uploader($configuration);
+
+$url = 'https://source.unsplash.com/random';
+$token = $uploader->fromUrl($url, null, null, 'auto', [
+    'action' => 'upload from URL', // The "Action" is the metadata key
+    'checkDuplicates' => true,
+    'storeDuplicates' => false,
+]);
+
+echo \sprintf('Upload from URL \'%s\' has been started. Token is %s', $url, $token);
diff --git a/api-samples/upload-api/post-group.php b/api-samples/upload-api/post-group.php
@@ -0,0 +1,8 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$uploader = new Uploadcare\Uploader\Uploader($configuration);
+
+$result = $uploader->groupFiles(['d6d34fa9-addd-472c-868d-2e5c105f9fcd', 'b1026315-8116-4632-8364-607e64fca723/-/resize/x800/']);
+
+echo \sprintf('Response status is %s', $result->getStatusCode());
diff --git a/api-samples/upload-api/post-multipart-start.php b/api-samples/upload-api/post-multipart-start.php
@@ -0,0 +1,12 @@
+<?php
+
+$configuration = Uploadcare\Configuration::create((string) $_ENV['UPLOADCARE_PUBLIC_KEY'], (string) $_ENV['UPLOADCARE_SECRET_KEY']);
+$uploader = new Uploadcare\Uploader\Uploader($configuration);
+
+$path = '/path-to-large-file.zip';
+$handle = \fopen($path, 'rb');
+$response = $uploader->fromResource($handle, null, null, 'auto', [
+    'size' => \filesize($path), // The "size" is the metadata key
+]);
+
+echo \sprintf('File uploaded. ID is \'%s\'', $response->getUuid());
diff --git a/src/Apis/MetadataApi.php b/src/Apis/MetadataApi.php
diff --git a/src/Interfaces/Api/MetadataApiInterface.php b/src/Interfaces/Api/MetadataApiInterface.php
