feat: Add support for the Notifications API

src/CrowdinApiClient/Api/Enterprise/NotificationApi.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace CrowdinApiClient\Api\Enterprise;
+
+use CrowdinApiClient\Api\AbstractApi;
+
+/**
+ * Send notifications
+ *
+ * @package Crowdin\Api\Entreprise
+ */
+class NotificationApi extends AbstractApi
+{
+
+    /**
+     * Send Notification To Organization Members
+     * @link https://developer.crowdin.com/enterprise/api/v2/#operation/api.notify.post  API Documentation Enterprise
+     *
+     * @param array $data
+     *  string $data[message] required<br>
+     *  string $data[role] Enum: "owner" "admin"<br>
+     *  integer[] $data[userIds]
+     * @return mixed
+     */
+    public function sendNotificationToOrganizationMembers(array $data)
+    {
+        $path = 'notify';
+
+        $options = [
+            'body' => json_encode($data),
+            'headers' => ['Content-Type' => 'application/json']
+        ];
+
+        return $this->client->apiRequest('post', $path, null, $options);
+    }
+}

src/CrowdinApiClient/Api/NotificationApi.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace CrowdinApiClient\Api;
+
+/**
+ * Send notifications
+ *
+ * @package Crowdin\Api
+ */
+class NotificationApi extends AbstractApi
+{
+    /**
+     * Send Notification to Authenticated User
+     * @link https://developer.crowdin.com/api/v2/#operation/api.notify.post  API Documentation
+     *
+     * @param array $data
+     *  string $data[message] required
+     * @return mixed
+     */
+    public function sendToAuthenticatedUser(array $data)
+    {
+        $path = 'notify';
+
+        $options = [
+            'body' => json_encode($data),
+            'headers' => ['Content-Type' => 'application/json']
+        ];
+
+        return $this->client->apiRequest('post', $path, null, $options);
+
+    }
+
+    /**
+     * Send Notification To Project Members
+     * @link https://developer.crowdin.com/api/v2/#operation/api.projects.notify.post  API Documentation
+     *
+     * @param int $projectId
+     * @param array $data
+     *  string $data[message] required<br>
+     *  string $data[role] Enum: "owner" "manager"<br>
+     *  integer[] $data[userIds]
+     * @return mixed
+     */
+    public function sendNotificationToProjectMembers(int $projectId, array $data)
+    {
+        $path = sprintf('projects/%s/notify', $projectId);
+
+        $options = [
+            'body' => json_encode($data),
+            'headers' => ['Content-Type' => 'application/json']
+        ];
+
+        return $this->client->apiRequest('post', $path, null, $options);
+    }
+}

src/CrowdinApiClient/Crowdin.php

@@ -42,6 +42,7 @@
  * @property \CrowdinApiClient\Api\Enterprise\TeamApi team
  * @property \CrowdinApiClient\Api\Enterprise\TeamMemberApi teamMember
  * @property \CrowdinApiClient\Api\BundleApi bundle
+ * @property \CrowdinApiClient\Api\NotificationApi|\CrowdinApiClient\Api\Enterprise\NotificationApi notification
  */
 class Crowdin
 {
@@ -106,7 +107,8 @@ class Crowdin
         'translation',
         'translationStatus',
         'distribution',
-        'bundle'
+        'bundle',
+        'notification'
     ];
 
     protected $servicesEnterprise = [
@@ -139,7 +141,8 @@ class Crowdin
         'distribution',
         'team',
         'teamMember',
-        'bundle'
+        'bundle',
+        'notification'
     ];
 
     /**

tests/CrowdinApiClient/Api/Enterprise/NotificationApiTest.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace CrowdinApiClient\Tests\Api\Enterprise;
+
+class NotificationApiTest extends AbstractTestApi
+{
+
+    public function testSendNotificationToOrganizationMembers()
+    {
+        $params = [
+            'message' => 'New notification message',
+            'userIds' => [1]
+        ];
+
+        $this->mockRequest([
+            'method' => 'post',
+            'uri' => 'https://organization_domain.crowdin.com/api/v2/notify',
+            'body' => $params,
+            'response' => null
+        ]);
+
+        $this->crowdin->notification->sendNotificationToOrganizationMembers($params);
+    }
+}

tests/CrowdinApiClient/Api/NotificationApiTest.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace CrowdinApiClient\Tests\Api;
+
+class NotificationApiTest extends AbstractTestApi
+{
+
+    public function testSendToAuthenticatedUser()
+    {
+        $params = [
+            'message' => 'New notification message',
+        ];
+
+        $this->mockRequest([
+            'method' => 'post',
+            'uri' => 'https://api.crowdin.com/api/v2/notify',
+            'body' => $params,
+            'response' => null
+        ]);
+
+        $this->crowdin->notification->sendToAuthenticatedUser($params);
+    }
+
+    public function testSendNotificationToProjectMembers()
+    {
+        $params = [
+            'message' => 'New notification message',
+            'userIds' => [1]
+        ];
+
+        $this->mockRequest([
+            'method' => 'post',
+            'uri' => 'https://api.crowdin.com/api/v2/projects/2/notify',
+            'body' => $params,
+            'response' => null
+        ]);
+
+        $this->crowdin->notification->sendNotificationToProjectMembers(2, $params);
+    }
+}