Refactor PromoOfferRequestTrackingCode class methods and enhance tests

- Renamed `request` method to `create` for clarity and updated its URL to `CREATE_URL`.
- Added `get` method to retrieve the status of a promo code request, including detailed type hints and Google-style docstrings.
- Updated test cases in `test_promo_offers.py` to reflect method name changes and validate new functionality, including checking for `request_id` in responses.

Author: nnnLik

admitad/items/promo_offers.py

@@ -43,9 +43,10 @@ class PromoOfferRequestTrackingCode(Item):
 
     SCOPE = 'request_tracking_coupon'
 
-    URL = Item.prepare_url('advcampaigns/request-tracking-coupon')
+    CREATE_URL = Item.prepare_url('tracking_promo_code/request-tracking-coupon')
+    GET_STATUS_URL = Item.prepare_url('tracking_promo_codes/request-status')
 
-    def request(
+    def create(
         self,
         coupon_id: int,
         advcampaign_id: int,
@@ -62,6 +63,7 @@ def request(
                 {
                     "assigned_promo_code": str | None,  # promo code or None if request is created
                     "tracking_link": str | None,        # tracking link or None
+                    "request_id": int | None,           # request id or None
                 }
         """
         request_data = {
@@ -73,5 +75,31 @@ def request(
         return (
             self.transport.post()
             .set_data(request_data)
-            .request(url=self.URL)
+            .request(url=self.CREATE_URL)
+        )
+
+    def get(self, request_id: int) -> dict:
+        """
+        Args:
+            request_id:  Admitad promocode request id
+
+        Returns:
+            dict: Status of the promocode request
+            {
+                "request_id": int,
+                "promo_offer_id": int,
+                "website_id": int,
+                "status": str,
+                "approved_at": datetime | None,
+                "declined_at": datetime | None,
+                "created_at": datetime,
+                "assigned_promo_code": str | None,
+            }
+        """
+        request_id = Item.sanitize_id(request_id)
+
+        return (
+            self.transport.get()
+            .set_params({'request_id': request_id})
+            .request(url=self.GET_STATUS_URL)
         )

admitad/tests/test_promo_offers.py

@@ -38,7 +38,7 @@ def test_request_tracking_promo_code_success(self) -> None:
                 },
                 status=200
             )
-            result = self.client.PromoOfferRequestTrackingCode.request(
+            result = self.client.PromoOfferRequestTrackingCode.create(
                 coupon_id=100,
                 advcampaign_id=200,
                 website_id=300
@@ -55,11 +55,12 @@ def test_request_tracking_promo_code_creates_request(self) -> None:
                 PromoOfferRequestTrackingCode.URL,
                 json={
                     'assigned_promo_code': None,
-                    'tracking_link': None
+                    'tracking_link': None,
+                    'request_id': 123,
                 },
                 status=200
             )
-            result = self.client.PromoOfferRequestTrackingCode.request(
+            result = self.client.PromoOfferRequestTrackingCode.create(
                 coupon_id=100,
                 advcampaign_id=200,
                 website_id=300
@@ -69,6 +70,7 @@ def test_request_tracking_promo_code_creates_request(self) -> None:
         self.assertIn('tracking_link', result)
         self.assertIsNone(result['assigned_promo_code'])
         self.assertIsNone(result['tracking_link'])
+        self.assertEqual(result['request_id'], 123)
 
     def test_request_tracking_promo_code_no_coupon_error(self) -> None:
         with responses.RequestsMock() as resp:
@@ -81,7 +83,7 @@ def test_request_tracking_promo_code_no_coupon_error(self) -> None:
                 status=400
             )
             with self.assertRaises(HttpException):
-                self.client.PromoOfferRequestTrackingCode.request(
+                self.client.PromoOfferRequestTrackingCode.create(
                     coupon_id=100,
                     advcampaign_id=200,
                     website_id=300
@@ -98,31 +100,31 @@ def test_request_tracking_promo_code_not_connected_error(self) -> None:
                 status=400
             )
             with self.assertRaises(HttpException):
-                self.client.PromoOfferRequestTrackingCode.request(
+                self.client.PromoOfferRequestTrackingCode.create(
                     coupon_id=100,
                     advcampaign_id=200,
                     website_id=300
                 )
 
     def test_request_tracking_promo_code_invalid_coupon_id(self) -> None:
         with self.assertRaises(ValueError):
-            self.client.PromoOfferRequestTrackingCode.request(
-                coupon_id=0,
+            self.client.PromoOfferRequestTrackingCode.create(
+                coupon_id=0,  # Invalid ID
                 advcampaign_id=200,
                 website_id=300
             )
 
     def test_request_tracking_promo_code_invalid_advcampaign_id(self) -> None:
         with self.assertRaises(ValueError):
-            self.client.PromoOfferRequestTrackingCode.request(
+            self.client.PromoOfferRequestTrackingCode.create(
                 coupon_id=100,
                 advcampaign_id=0,
                 website_id=300
             )
 
     def test_request_tracking_promo_code_invalid_website_id(self) -> None:
         with self.assertRaises(ValueError):
-            self.client.PromoOfferRequestTrackingCode.request(
+            self.client.PromoOfferRequestTrackingCode.create(
                 coupon_id=100,
                 advcampaign_id=200,
                 website_id=0,