Pincode Serviceability API

Author: maxvoronov

src/Api.php

@@ -1,6 +1,6 @@
 <?php
 
-declare(strict_types = 1);
+declare(strict_types=1);
 
 namespace OpsWay\Clickpost;
 
@@ -37,7 +37,7 @@ class Api
     protected $endpointUrl;
 
     /**
-     * Api constructor.
+     * Api constructor
      *
      * @param bool $production
      */
@@ -51,7 +51,7 @@ public function __construct(bool $production = true)
      */
     public function getClient(): Client
     {
-        if (\is_null($this->client)) {
+        if ($this->client === null) {
             $this->setClient(new Client($this->production, $this->getEndpointUrl()));
         }
         return $this->client;
@@ -184,13 +184,24 @@ public function cancel()
         return new Api\CancelOrder($this->getClient(), $this->getUsername(), $this->getApiKey());
     }
 
+    /**
+     * @return Api\PincodeServiceability
+     *
+     * @throws \Exception
+     */
+    public function pincodeServiceability()
+    {
+        $this->validateApi();
+        return new Api\PincodeServiceability($this->getClient(), $this->getUsername(), $this->getApiKey());
+    }
+
     /**
      * @throws \Exception
      */
     private function validateApi()
     {
         if (empty($this->getApiKey()) || empty($this->getUsername())) {
-            throw new \Exception("API not fully configured", 422);
+            throw new \Exception('API not fully configured', 422);
         }
     }
 }

src/Api/PincodeServiceability.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpsWay\Clickpost\Api;
+
+class PincodeServiceability extends BaseApi
+{
+    private const API_PATH = 'serviceability_api';
+
+    private const VERSION = 'v1';
+
+    /**
+     * @param array $data
+     *
+     * @return object
+     *
+     * @throws \Exception
+     */
+    public function get(array $data): object
+    {
+        $apiUrl = sprintf('%s/%s/', self::VERSION, self::API_PATH);
+        $auth = new Auth($this->username, $this->apiKey);
+
+        return $this->client->post($apiUrl, $data, $auth);
+    }
+}