Add method to get audiobook chapters (#476)

Author: joostlek

src/spotifyaio/models.py

@@ -648,6 +648,13 @@ class Chapter(DataClassORJSONMixin):
     external_urls: dict[str, str]
 
 
+@dataclass
+class AudiobookChapterResponse(DataClassORJSONMixin):
+    """Audiobook chapter response model."""
+
+    items: list[Chapter]
+
+
 @dataclass
 class Author(DataClassORJSONMixin):
     """Author model."""

src/spotifyaio/spotify.py

@@ -21,13 +21,15 @@
     ArtistResponse,
     ArtistTopTracksResponse,
     Audiobook,
+    AudiobookChapterResponse,
     AudiobooksResponse,
     AudioFeatures,
     BasePlaylist,
     BaseUserProfile,
     CategoriesResponse,
     Category,
     CategoryPlaylistResponse,
+    Chapter,
     CurrentPlaying,
     Device,
     Devices,
@@ -287,7 +289,14 @@ async def get_audiobooks(self, audiobook_ids: list[str]) -> list[Audiobook]:
         response = await self._get("v1/audiobooks", params=params)
         return AudiobooksResponse.from_json(response).audiobooks
 
-    # Get an audiobook's episodes
+    async def get_audiobook_chapters(self, audiobook_id: str) -> list[Chapter]:
+        """Get audiobook chapters."""
+        identifier = get_identifier(audiobook_id)
+        params: dict[str, Any] = {"limit": 50}
+        response = await self._get(
+            f"v1/audiobooks/{identifier}/chapters", params=params
+        )
+        return AudiobookChapterResponse.from_json(response).items
 
     # Get saved audiobooks