generator-java: make position parameter optional in endpoint add tracks to playlist

Author: sonallux

spotify-web-api-generator-java/src/main/java/de/sonallux/spotify/generator/java/EndpointHelper.java

@@ -31,7 +31,9 @@ public static void fixDuplicateEndpointParameters(SpotifyWebApiEndpoint endpoint
             endpoint.getParameters().removeIf(p -> p.getLocation() == QUERY && paramName.equals(p.getName()));
             for (var param : endpoint.getParameters()) {
                 if (param.getLocation() == BODY && paramName.equals(param.getName())) {
-                    param.setRequired(true);
+                    if (!("endpoint-add-tracks-to-playlist".equals(endpoint.getId()) && "position".equals(param.getName()))) {
+                        param.setRequired(true);
+                    }
                 } else if (param.getLocation() == HEADER && "Content-Type".equals(param.getName())) {
                     param.setRequired(true);
                 }

spotify-web-api-java/src/main/generated/de/sonallux/spotify/api/apis/PlaylistsApi.java

@@ -16,11 +16,10 @@ public class PlaylistsApi {
      * <p>Add one or more items to a user's playlist.</p>
      * @param playlistId <p>The <a href="https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids">Spotify ID</a> for the playlist.</p>
      * @param uris <p>A JSON array of the <a href="https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids">Spotify URIs</a> to add. For example: <code>{&quot;uris&quot;: [&quot;spotify:track:4iV5W9uYEdYUVa79Axb7Rh&quot;,&quot;spotify:track:1301WleyT98MSxVHPZCA6M&quot;, &quot;spotify:episode:512ojhOuo1ktJprKbVcKyQ&quot;]}</code><br>A maximum of 100 items can be added in one request. <em>Note: if the <code>uris</code> parameter is present in the query string, any URIs listed here in the body will be ignored.</em></p>
-     * @param position <p>The position to insert the items, a zero-based index. For example, to insert the items in the first position: <code>position=0</code> ; to insert the items in the third position: <code>position=2</code>. If omitted, the items will be appended to the playlist. Items are added in the order they appear in the uris array. For example: <code>{&quot;uris&quot;: [&quot;spotify:track:4iV5W9uYEdYUVa79Axb7Rh&quot;,&quot;spotify:track:1301WleyT98MSxVHPZCA6M&quot;], &quot;position&quot;: 3}</code></p>
      * @return a {@link AddTracksToPlaylistRequest} object to build and execute the request
      */
-    public AddTracksToPlaylistRequest addTracksToPlaylist(String playlistId, java.util.List<String> uris, int position) {
-        return new AddTracksToPlaylistRequest(apiClient, playlistId, uris, position);
+    public AddTracksToPlaylistRequest addTracksToPlaylist(String playlistId, java.util.List<String> uris) {
+        return new AddTracksToPlaylistRequest(apiClient, playlistId, uris);
     }
 
     /**

spotify-web-api-java/src/main/generated/de/sonallux/spotify/api/apis/playlists/AddTracksToPlaylistRequest.java

@@ -25,17 +25,23 @@ public class AddTracksToPlaylistRequest {
      * @param apiClient <p>The API client</p>
      * @param playlistId <p>The <a href="https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids">Spotify ID</a> for the playlist.</p>
      * @param uris <p>A JSON array of the <a href="https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids">Spotify URIs</a> to add. For example: <code>{&quot;uris&quot;: [&quot;spotify:track:4iV5W9uYEdYUVa79Axb7Rh&quot;,&quot;spotify:track:1301WleyT98MSxVHPZCA6M&quot;, &quot;spotify:episode:512ojhOuo1ktJprKbVcKyQ&quot;]}</code><br>A maximum of 100 items can be added in one request. <em>Note: if the <code>uris</code> parameter is present in the query string, any URIs listed here in the body will be ignored.</em></p>
-     * @param position <p>The position to insert the items, a zero-based index. For example, to insert the items in the first position: <code>position=0</code> ; to insert the items in the third position: <code>position=2</code>. If omitted, the items will be appended to the playlist. Items are added in the order they appear in the uris array. For example: <code>{&quot;uris&quot;: [&quot;spotify:track:4iV5W9uYEdYUVa79Axb7Rh&quot;,&quot;spotify:track:1301WleyT98MSxVHPZCA6M&quot;], &quot;position&quot;: 3}</code></p>
      */
-    public AddTracksToPlaylistRequest(ApiClient apiClient, String playlistId, java.util.List<String> uris, int position) {
+    public AddTracksToPlaylistRequest(ApiClient apiClient, String playlistId, java.util.List<String> uris) {
         this.apiClient = apiClient;
         this.request = new Request("POST", "/playlists/{playlist_id}/tracks")
             .addPathParameter("playlist_id", String.valueOf(playlistId))
             .addBodyParameter("uris", uris)
-            .addBodyParameter("position", position)
         ;
     }
 
+    /**
+     * <p>The position to insert the items, a zero-based index. For example, to insert the items in the first position: <code>position=0</code> ; to insert the items in the third position: <code>position=2</code>. If omitted, the items will be appended to the playlist. Items are added in the order they appear in the uris array. For example: <code>{&quot;uris&quot;: [&quot;spotify:track:4iV5W9uYEdYUVa79Axb7Rh&quot;,&quot;spotify:track:1301WleyT98MSxVHPZCA6M&quot;], &quot;position&quot;: 3}</code></p>
+     */
+    public AddTracksToPlaylistRequest position(int position) {
+        this.request.addBodyParameter("position", position);
+        return this;
+    }
+
     /**
      * Build the request into an executable call
      */