feature: add basic MapIt class with postcode method

README.md

@@ -21,7 +21,7 @@ use C6Digital\MapIt\MapIt;
 
 $mapIt = new MapIt(
     key: 'your-mapit-key-here',          // Your MapIt API key / token.
-    url: 'https://mapit.mysociety.org/'  // An optional MapIt URL.
+    url: 'https://mapit.mysociety.org'  // An optional MapIt URL.
 );
 ```
 

composer.json

@@ -15,7 +15,8 @@
         }
     ],
     "require": {
-        "php": "^8.2"
+        "php": "^8.2",
+        "illuminate/http": "^10.0"
     },
     "require-dev": {
         "pestphp/pest": "^2.15",

src/MapIt.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace C6Digital\MapIt;
+
+use Illuminate\Http\Client\PendingRequest;
+use Illuminate\Support\Facades\Http;
+
+class MapIt
+{
+    public function __construct(
+        protected string $key,
+        protected string $url = 'https://mapit.mysociety.org',
+    ) {}
+
+    public function postcode(string $postcode): ?array
+    {
+        return $this->client()->get("/postcode/{$postcode}")->json();
+    }
+
+    protected function client(): PendingRequest
+    {
+        return Http::baseUrl($this->url)
+            ->withQueryParameters(['api_key' => $this->key]);
+    }
+}