{"id":15688433,"url":"https://github.com/sonallux/spotify-web-api-java","last_synced_at":"2025-05-05T21:11:04.874Z","repository":{"id":36990667,"uuid":"102512840","full_name":"sonallux/spotify-web-api-java","owner":"sonallux","description":"A Java wrapper for Spotify's Web API","archived":false,"fork":false,"pushed_at":"2025-04-14T18:09:21.000Z","size":1000,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T19:25:05.579Z","etag":null,"topics":["api-client","java","spotify","spotify-web-api","wrapper"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sonallux.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-09-05T17:50:08.000Z","updated_at":"2025-04-14T18:09:23.000Z","dependencies_parsed_at":"2023-02-16T02:00:55.060Z","dependency_job_id":"647afe20-d28d-4daa-85f7-6919781bd870","html_url":"https://github.com/sonallux/spotify-web-api-java","commit_stats":{"total_commits":313,"total_committers":6,"mean_commits":"52.166666666666664","dds":0.5015974440894568,"last_synced_commit":"37d5c65da1b4d8de79147dd3d505de634baf1e89"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sonallux","download_url":"https://codeload.github.com/sonallux/spotify-web-api-java/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252577020,"owners_count":21770721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","java","spotify","spotify-web-api","wrapper"],"created_at":"2024-10-03T17:59:54.937Z","updated_at":"2025-05-05T21:11:04.856Z","avatar_url":"https://github.com/sonallux.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# spotify-web-api-java\n\n[![Build](https://github.com/sonallux/spotify-web-api-java/workflows/Build/badge.svg)](https://github.com/sonallux/spotify-web-api-java/actions?query=workflow%3ABuild)\n[![Maven Central](https://img.shields.io/maven-central/v/de.sonallux.spotify/spotify-web-api-java)](https://central.sonatype.com/artifact/de.sonallux.spotify/spotify-web-api-java)\n[![GitHub](https://img.shields.io/github/license/sonallux/spotify-web-api-java)](https://github.com/sonallux/spotify-web-api-java/blob/main/LICENSE)\n\nA Java wrapper for Spotify's Web API.\n\n## Installation\nThis library is available on [Maven Central](https://central.sonatype.com/artifact/de.sonallux.spotify/spotify-web-api-java) and requires at least Java 17.\n\n### With maven\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ede.sonallux.spotify\u003c/groupId\u003e\n  \u003cartifactId\u003espotify-web-api-java\u003c/artifactId\u003e\n  \u003cversion\u003e4.3.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### With gradle\n```groovy\ncompile 'de.sonallux.spotify:spotify-web-api-java:4.3.1'\n```\n\n## General usage\n```java\nvar authProvider = new SimpleApiAuthorizationProvider(\"\u003cyour access token\u003e\");\nvar spotifyApi = SpotifyWebApi.builder().authorization(authProvider).build();\n\nvar artist = spotifyApi.getArtistsApi().getArtist(\"\u003cartist id\u003e\").build().execute();\nSystem.out.println(artist.getName());\n```\n\n## Authorization\nSpotify's web API supports different [authorization flows](https://developer.spotify.com/documentation/web-api/concepts/authorization). All flows require that your application is registered on the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard). You can find more details on how to register your app [here](https://developer.spotify.com/documentation/web-api/concepts/apps). After successful registration you can use one of the following authorization flows with the `spotify-web-api-java`:\n\n### [Authorization code flow](https://developer.spotify.com/documentation/web-api/tutorials/code-flow)\nCode example: [AuthorizationCodeExample.java](spotify-web-api-java/src/test/java/examples/AuthorizationCodeExample.java)\n### [Authorization code flow with proof key for code exchange (PKCE)](https://developer.spotify.com/documentation/web-api/tutorials/code-pkce-flow)\nCode example: [AuthorizationCodePKCEExample.java](spotify-web-api-java/src/test/java/examples/AuthorizationCodePKCEExample.java)\n### [Implicit grant](https://developer.spotify.com/documentation/web-api/tutorials/implicit-flow)\nCode example: [ImplicitGrantExample.java](spotify-web-api-java/src/test/java/examples/ImplicitGrantExample.java)\n### [Client credentials flow](https://developer.spotify.com/documentation/web-api/tutorials/client-credentials-flow)\nCode example: [ClientCredentialsExample.java](spotify-web-api-java/src/test/java/examples/ClientCredentialsExample.java)\n\n## How to release a new version\n1. Update the version number with `./mvnw versions:set -DnewVersion=\"\u003cversion\u003e\" -DgenerateBackupPoms=false`\n2. Update version in `CHANGELOG.md` and `README.md`\n3. Commit and push changes to GitHub\n4. Wait till CI is green\n5. Tag the commit created in step 3 and push it. A GitHub actions workflow will automatically deploy the artifacts to Maven Central.\n6. Create a release on GitHub mentioning the changes from `CHANGELOG.md`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonallux%2Fspotify-web-api-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsonallux%2Fspotify-web-api-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonallux%2Fspotify-web-api-java/lists"}