feat: add support for listing organizations

fixture/GET/organizations.json

@@ -0,0 +1,37 @@
+{
+  "organizations": [
+    {
+      "url": "https://example.zendesk.com/api/v2/organizations/361898904439.json",
+      "id": 361898904439,
+      "name": "Rebel Alliance",
+      "shared_tickets": true,
+      "shared_comments": true,
+      "created_at": "2019-09-17T21:22:18Z",
+      "updated_at": "2019-09-17T21:22:18Z",
+      "domain_names": [
+        "hoth.com",
+        "dantooine.com"
+      ],
+      "group_id": null,
+      "tags": [
+        "test"
+      ]
+    },
+    {
+      "url": "https://example.zendesk.com/api/v2/organizations/361898904440.json",
+      "id": 361898904440,
+      "name": "Imperial Senate",
+      "shared_tickets": true,
+      "shared_comments": true,
+      "created_at": "2019-09-17T21:22:18Z",
+      "updated_at": "2019-09-17T21:22:18Z",
+      "domain_names": [
+        "coruscant.com"
+      ],
+      "group_id": null,
+      "tags": [
+        "test"
+      ]
+    }
+  ]
+}

zendesk/organization.go

@@ -23,14 +23,53 @@ type Organization struct {
 	OrganizationFields map[string]interface{} `json:"organization_fields,omitempty"`
 }
 
+// OrganizationListOptions is options for GetOrganizations
+//
+// ref: https://developer.zendesk.com/rest_api/docs/support/organizations#list-organizations
+type OrganizationListOptions struct {
+	PageOptions
+}
+
 // OrganizationAPI an interface containing all methods associated with zendesk organizations
 type OrganizationAPI interface {
+	GetOrganizations(ctx context.Context, opts *OrganizationListOptions) ([]Organization, Page, error)
 	CreateOrganization(ctx context.Context, org Organization) (Organization, error)
 	GetOrganization(ctx context.Context, orgID int64) (Organization, error)
 	UpdateOrganization(ctx context.Context, orgID int64, org Organization) (Organization, error)
 	DeleteOrganization(ctx context.Context, orgID int64) error
 }
 
+// GetOrganizations fetch organization list
+//
+// ref: https://developer.zendesk.com/rest_api/docs/support/organizations#getting-organizations
+func (z *Client) GetOrganizations(ctx context.Context, opts *OrganizationListOptions) ([]Organization, Page, error) {
+	var data struct {
+		Organizations []Organization `json:"organizations"`
+		Page
+	}
+
+	if opts == nil {
+		return []Organization{}, Page{}, &OptionsError{opts}
+	}
+
+	u, err := addOptions("/organizations.json", opts)
+	if err != nil {
+		return []Organization{}, Page{}, err
+	}
+
+	body, err := z.get(ctx, u)
+	if err != nil {
+		return []Organization{}, Page{}, err
+	}
+
+	err = json.Unmarshal(body, &data)
+	if err != nil {
+		return []Organization{}, Page{}, err
+	}
+
+	return data.Organizations, data.Page, nil
+}
+
 // CreateOrganization creates new organization
 // https://developer.zendesk.com/rest_api/docs/support/organizations#create-organization
 func (z *Client) CreateOrganization(ctx context.Context, org Organization) (Organization, error) {

zendesk/organization_test.go

@@ -33,6 +33,21 @@ func TestGetOrganization(t *testing.T) {
 	}
 }
 
+func TestGetOrganizations(t *testing.T) {
+	mockAPI := newMockAPI(http.MethodGet, "organizations.json")
+	client := newTestClient(mockAPI)
+	defer mockAPI.Close()
+
+	orgs, _, err := client.GetOrganizations(ctx, &OrganizationListOptions{})
+	if err != nil {
+		t.Fatalf("Failed to get organizations: %s", err)
+	}
+
+	if len(orgs) != 2 {
+		t.Fatalf("expected length of organizations is , but got %d", len(orgs))
+	}
+}
+
 func TestUpdateOrganization(t *testing.T) {
 	mockAPI := newMockAPIWithStatus(http.MethodPut, "organization.json", http.StatusOK)
 	client := newTestClient(mockAPI)