feat: add ability to add a bookmark to an episode

src/deezer/client.py

@@ -125,6 +125,8 @@ def _process_json(
             object_class = Resource
         elif resource_type:
             object_class = resource_type
+        elif item.get("results") is True:
+            return True
         else:
             raise DeezerUnknownResource(f"Unable to find resource type for {result!r}")
         assert object_class is not None  # nosec B101
@@ -165,7 +167,7 @@ def request(
         json_data = response.json()
         if not isinstance(json_data, dict):
             return json_data
-        if "error" in json_data:
+        if "error" in json_data and json_data["error"]:
             raise DeezerErrorResponse(json_data)
         return self._process_json(
             json_data,

src/deezer/resources/episode.py

@@ -41,3 +41,17 @@ def _infer_missing_field(self, item) -> Any:
         elif item == "share":
             return f"{self.link}?utm_source=deezer&utm_content=episode-{self.id}&utm_medium=web"
         return super()._infer_missing_field(item)
+
+    def add_bookmark(self, offset: int, **kwargs) -> bool:
+        """
+        Sets a bookmark on the episode.
+
+        :param offset: The offset where the bookmark is set, must be between 0 and 100.
+        :returns: a boolean that tells if the operation was successful
+        """
+        return self.client.request(
+            "POST",
+            f"episode/{self.id}/bookmark",
+            offset=offset,
+            **kwargs,
+        )

tests/resources/cassettes/TestEpisode.test_add_bookmark.yaml

@@ -0,0 +1,56 @@
+interactions:
+  - request:
+      body: null
+      headers:
+        Accept:
+          - "*/*"
+        Accept-Encoding:
+          - identity
+        Connection:
+          - keep-alive
+        Content-Length:
+          - "0"
+        User-Agent:
+          - python-requests/2.30.0
+      method: POST
+      uri: https://api.deezer.com/episode/343457312/bookmark?access_token=dummy&offset=55
+    response:
+      body:
+        string: '{"error":[],"results":true}'
+      headers:
+        Access-Control-Allow-Credentials:
+          - "true"
+        Access-Control-Allow-Headers:
+          - X-Requested-With, Content-Type, Authorization, Origin, Accept, Accept-Encoding
+        Access-Control-Allow-Methods:
+          - POST, GET, OPTIONS, DELETE, PUT
+        Access-Control-Expose-Headers:
+          - Location
+        Access-Control-Max-Age:
+          - "86400"
+        Cache-Control:
+          - no-store, no-cache, must-revalidate
+        Connection:
+          - keep-alive
+        Content-Length:
+          - "27"
+        Content-Type:
+          - application/json; charset=utf-8
+        Expires:
+          - Thu, 19 Nov 1981 08:52:00 GMT
+        Pragma:
+          - no-cache
+        Server:
+          - Apache
+        Strict-Transport-Security:
+          - max-age=31536000; includeSubDomains
+        X-Content-Type-Options:
+          - nosniff
+        X-Host:
+          - blm-web-136
+        x-org:
+          - FR
+      status:
+        code: 200
+        message: OK
+version: 1

tests/resources/test_episode.py

@@ -44,3 +44,14 @@ def test_access_non_inferable_field(self, client):
             },
         )
         assert episode.duration == 3254
+
+    def test_add_bookmark(self, client_token):
+        episode = deezer.Episode(
+            client_token,
+            json={
+                "id": 343457312,
+                "type": "episode",
+            },
+        )
+        result = episode.add_bookmark(55)
+        assert result is True