Merge pull request #243 from asknicely/get-single-company

Get a single company by ID

Author: GabrielAnca

README.md

@@ -270,6 +270,9 @@ $client->companies->update([
 
 /** List Companies */
 $client->companies->getCompanies([]);
+
+/** Get a company by ID */
+$client->companies->getCompany("531ee472cce572a6ec000006");
 ```
 
 ## Admins

src/IntercomCompanies.php

@@ -58,4 +58,28 @@ public function getCompanies($options)
     {
         return $this->client->get("companies", $options);
     }
+
+    /**
+     * Gets a single Company based on the Intercom ID.
+     *
+     * @see    https://developers.intercom.com/reference#view-a-company
+     * @param  string $id
+     * @param  array  $options
+     * @return mixed
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     */
+    public function getCompany($id, $options = [])
+    {
+        $path = $this->companyPath($id);
+        return $this->client->get($path, $options);
+    }
+
+    /**
+     * @param string $id
+     * @return string
+     */
+    public function companyPath($id)
+    {
+        return 'companies/' . $id;
+    }
 }

test/IntercomCompaniesTest.php

@@ -36,4 +36,20 @@ public function testCompanyGet()
         $companies = new IntercomCompanies($stub);
         $this->assertEquals('foo', $companies->getCompanies([]));
     }
+
+    public function testCompanyPath()
+    {
+        $stub = $this->getMockBuilder('Intercom\IntercomClient')->disableOriginalConstructor()->getMock();
+        $users = new IntercomCompanies($stub);
+        $this->assertEquals('companies/foo', $users->companyPath("foo"));
+    }
+
+    public function testCompanyGetById()
+    {
+        $stub = $this->getMockBuilder('Intercom\IntercomClient')->disableOriginalConstructor()->getMock();
+        $stub->method('get')->willReturn('foo');
+
+        $users = new IntercomCompanies($stub);
+        $this->assertEquals('foo', $users->getCompany("foo"));
+    }
 }