Cancel parcels

Author: Sander de Vos

readme.md

@@ -6,6 +6,7 @@ Supported endpoints:
 - `GET` parcels
 - `GET` parcels/{id}
 - `POST` parcels
+- `POST` parcels/{id}/cancel
 - `GET` shipping_methods
 
 [![tests](https://github.com/sander3/laravel-sendcloud/workflows/Laravel/badge.svg)](https://github.com/sander3/laravel-sendcloud/actions?query=workflow%3ALaravel)

src/Sendcloud.php

@@ -36,6 +36,13 @@ public function createParcel(ParcelData $parcel, SenderData $sender = null): arr
         return $this->request('post', self::PARCELS_ENDPOINT, $data);
     }
 
+    public function deleteParcel(int $id): array
+    {
+        $endpoint = self::PARCELS_ENDPOINT.'/'.$id.'/cancel';
+
+        return $this->request('post', $endpoint, [], false);
+    }
+
     public function shippingMethods(array $optionalParameters = []): array
     {
         $query = http_build_query($optionalParameters);
@@ -45,13 +52,15 @@ public function shippingMethods(array $optionalParameters = []): array
         return $this->request('get', $endpoint);
     }
 
-    private function request(string $method, string $endpoint, array $data = null): array
+    private function request(string $method, string $endpoint, array $data = [], bool $throwException = true): array
     {
         $response = Http::withBasicAuth(config('sendcloud.key'), config('sendcloud.secret'))
             ->{$method}($this->getUrl($endpoint), $data);
 
-        // Throw an exception if a client or server error occurred...
-        $response->throw();
+        if ($throwException) {
+            // Throw an exception if a client or server error occurred...
+            $response->throw();
+        }
 
         return $response->json();
     }