update: change api version

README.md

@@ -111,6 +111,15 @@ $orders = $client->Order->getOrderList([
 ]);
 ```
 
+## Change API version
+
+> As default, API version 202309 will be used in every api call
+> Use below example to change it
+
+```php
+$products = $client->Product->useVersion('202312')->checkListingPrerequisites(); 
+```
+
 ## Webhook
 
 Use webhook to receive incoming notification from tiktok shop

src/Resource.php

@@ -11,6 +11,7 @@
 namespace EcomPHP\TiktokShop;
 
 use DateTimeInterface;
+use EcomPHP\TiktokShop\Errors\TiktokShopException;
 use GuzzleHttp\Client;
 use GuzzleHttp\Exception\GuzzleException;
 use EcomPHP\TiktokShop\Client as TiktokShopClient;
@@ -32,12 +33,20 @@ abstract class Resource
 
     public function useVersion($version)
     {
+        if (intval($version) < 202309) {
+            throw new TiktokShopException('API version 202309 is the minimum requirement');
+        }
+
         $this->version = $version;
+
+        return $this;
     }
 
     public function useHttpClient(Client $client)
     {
         $this->httpClient = $client;
+
+        return $this;
     }
 
     /**

tests/ResourceTest.php

@@ -10,13 +10,16 @@
 
 namespace EcomPHP\TiktokShop\Tests;
 
+use EcomPHP\TiktokShop\Errors\TiktokShopException;
 use GuzzleHttp\Client;
 use GuzzleHttp\Handler\MockHandler;
 use GuzzleHttp\HandlerStack;
+use GuzzleHttp\Middleware;
 use GuzzleHttp\Psr7\Response;
 use EcomPHP\TiktokShop\Errors\ResponseException;
 use EcomPHP\TiktokShop\Resource;
 use PHPUnit\Framework\TestCase;
+use ReflectionClass;
 
 class ResourceTest extends TestCase
 {
@@ -57,4 +60,29 @@ public function testLastMessageAndRequestId()
         $this->assertEquals($this->resource->getLastMessage(), 'error message');
         $this->assertEquals($this->resource->getLastRequestId(), 'request id');
     }
+
+    public function testChangeAPIVersion()
+    {
+        $container = [];
+
+        $mockHandler = new MockHandler();
+        $mockHandler->append(new Response(200, [], '{"code":0,"message":"success","data":[],"request_id":"sample request id"}'));
+
+        $handler = HandlerStack::create($mockHandler);
+        $handler->push(Middleware::history($container));
+
+        $this->resource->useHttpClient(new Client([
+            'handler' => $handler
+        ]));
+
+        // test newer version
+        $this->resource->useVersion('202409')->call('GET', 'test-api');
+        $request = array_pop($container)['request'];
+        $this->assertEquals('202409/test-api', $request->getUri()->getPath());
+
+        // test older version
+        $this->expectException(TiktokShopException::class);
+        $this->expectExceptionMessage('API version 202309 is the minimum requirement');
+        $this->resource->useVersion('202109')->call('GET', 'test-api');
+    }
 }