add verified domains endpoint with test

Author: Jhut89

README.md

@@ -381,10 +381,12 @@ print $contact_email; // outputs something like "example@domain.com"
       |----templateFolders()            
       |                                 
       |----templates()                  
-           |                            
-           |----defaultContent()        
-                                    
-                                    
+      |    |                            
+      |    |----defaultContent()        
+      |                             
+      |----verifiedDomains()
+           |
+           |----verify()                            
                                     
                                     
 

src/Mailchimp.php

@@ -239,6 +239,16 @@ public function templates($template_id = null)
         return new Resources\Templates($this->request, $this->settings, $template_id);
     }
 
+    /**
+     * @param null $domain_name
+     *
+     * @return Resources\VerifiedDomains
+     */
+    public function verifiedDomains($domain_name = null)
+    {
+        return new Resources\VerifiedDomains($this->request, $this->settings, $domain_name);
+    }
+
     /**
      * @param $client_id
      * @param $redirect_uri

src/Resources/VerifiedDomains.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace MailchimpAPI\Resources;
+
+
+use MailchimpAPI\Requests\MailchimpRequest;
+use MailchimpAPI\Settings\MailchimpSettings;
+
+/**
+ * Class VerifiedDomains
+ * Represents the Verified Domains Mailchimp API endpoint
+ * @package MailchimpAPI\Resources
+ */
+class VerifiedDomains extends ApiResource
+{
+    /* @var string */
+    private $domain_name;
+
+    /**
+     * The url component for this endpoint
+     */
+    const URL_COMPONENT = '/verified-domains/';
+
+    const VERIFY_URL_COMPONENT = '/actions/verify';
+
+    /**
+     * VerifiedDomains constructor.
+     *
+     * @param MailchimpRequest $request
+     * @param MailchimpSettings $settings
+     * @param null $domain_name
+     */
+    public function __construct(MailchimpRequest $request, MailchimpSettings $settings, $domain_name = null)
+    {
+        parent::__construct($request, $settings);
+        $request->appendToEndpoint(self::URL_COMPONENT . $domain_name);
+        $this->domain_name = $domain_name;
+    }
+
+    /**
+     * @return \MailchimpAPI\Responses\MailchimpResponse
+     * @throws \MailchimpAPI\MailchimpException
+     */
+    public function verify()
+    {
+        $this->throwIfNot("domain-name", $this->domain_name);
+        return $this->postToActionEndpoint(self::VERIFY_URL_COMPONENT);
+    }
+}

tests/VerifiedDomainsTest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace MailchimpTests;
+
+use MailchimpAPI\Resources\VerifiedDomains;
+
+class VerifiedDomainsTest extends MailChimpTestCase
+{
+    public function testVerifiedDomainsCollectionEndpoint()
+    {
+        $this->endpointUrlBuildTest(
+            VerifiedDomains::URL_COMPONENT,
+            $this->mailchimp->verifiedDomains(),
+            "The verified domains collection endpoint should be constructed correctly"
+        );
+    }
+
+    public function testVerifiedDomainsInstanceEndpoint()
+    {
+        $this->endpointUrlBuildTest(
+            VerifiedDomains::URL_COMPONENT . 'my-domain',
+            $this->mailchimp->verifiedDomains('my-domain'),
+            "The verified domains instance endpoint should be constructed correctly"
+        );
+    }
+}