{"id":13433112,"url":"https://github.com/sonallux/spotify-web-api","last_synced_at":"2025-04-06T04:11:55.113Z","repository":{"id":36986584,"uuid":"284985656","full_name":"sonallux/spotify-web-api","owner":"sonallux","description":"Tools for fixing and improving the official Spotify OpenAPI definition.","archived":false,"fork":false,"pushed_at":"2025-03-28T06:23:42.000Z","size":1952,"stargazers_count":89,"open_issues_count":6,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-30T03:06:00.170Z","etag":null,"topics":["open-api","open-api-specification","openapi","spotify","spotify-web-api","swagger"],"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":null,"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}},"created_at":"2020-08-04T13:17:57.000Z","updated_at":"2025-03-28T06:23:44.000Z","dependencies_parsed_at":"2023-02-12T19:45:14.276Z","dependency_job_id":"9bbaf7d2-1522-460d-89f8-a3de12eeb2a2","html_url":"https://github.com/sonallux/spotify-web-api","commit_stats":{"total_commits":461,"total_committers":4,"mean_commits":115.25,"dds":0.5553145336225597,"last_synced_commit":"09e0123cae08e7098a4b7485c288212f2f6d2336"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonallux%2Fspotify-web-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sonallux","download_url":"https://codeload.github.com/sonallux/spotify-web-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247430871,"owners_count":20937874,"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":["open-api","open-api-specification","openapi","spotify","spotify-web-api","swagger"],"created_at":"2024-07-31T02:01:21.180Z","updated_at":"2025-04-06T04:11:54.976Z","avatar_url":"https://github.com/sonallux.png","language":"Java","readme":"# Spotify Web API Tools\n\n[![Build](https://github.com/sonallux/spotify-web-api/workflows/Build/badge.svg)](https://github.com/sonallux/spotify-web-api/actions?query=workflow%3ABuild)\n[![Update OpenAPI definition](https://github.com/sonallux/spotify-web-api/actions/workflows/update-openapi.yml/badge.svg)](https://github.com/sonallux/spotify-web-api/actions/workflows/update-openapi.yml)\n[![Validate Open API](https://github.com/sonallux/spotify-web-api/actions/workflows/validate.yml/badge.svg)](https://github.com/sonallux/spotify-web-api/actions/workflows/validate.yml)\n[![Maven Central](https://img.shields.io/maven-central/v/de.sonallux.spotify/spotify-web-api-parent.svg?label=Maven%20Central)](https://search.maven.org/artifact/de.sonallux.spotify/spotify-web-api-parent)\n[![GitHub](https://img.shields.io/github/license/sonallux/spotify-web-api)](https://github.com/sonallux/spotify-web-api/blob/main/LICENSE)\n\nThis monorepo contains tools for fixing and improving the [official Spotify OpenAPI definition](https://developer.spotify.com/_data/documentation/web-api/reference/open-api-schema.yml). The fixed OpenAPI definition can be found in the [fixed-spotify-open-api.yml](fixed-spotify-open-api.yml) file.\n\n## Modules\n\n| Module                                                                             | Description                                                         |\n|------------------------------------------------------------------------------------|---------------------------------------------------------------------|\n| [json-utils](json-utils/README.md)                                                 | Utility classes for JSON/YAML                                       |\n| [spotify-web-api-open-api](spotify-web-api-open-api/README.md)                     | Apply the fixes and improvements to the official OpenAPI definition |\n\n## Versioning\nUnfortunately Spotify does not provide any version information with their Web API reference documentation. Therefore, I do **not** follow [semantic versioning](https://semver.org) when releasing new versions. Version do follow a schema based on the release date: `\u003cyear\u003e.\u003cmonth\u003e.\u003cday\u003e` (e.g. a version released on 30th March 2021 will get the version number `2021.3.30`).\n\n## Disclaimer\nBecause the documentation are only based on the Spotify Web API Reference, there might be difference to the actual behaviour of the Spotify Web API. Also, neither do I have any connections to Spotify nor am I an employee at Spotify.\n\n## How to release a new version\n\nJust start the Release workflow in GitHub Actions or perform the following steps manually\n\n1. Update the version number with `./mvnw versions:set -DnewVersion=\"\u003cversion\u003e\" -DgenerateBackupPoms=false`\n2. Run OpenApiGenerator to update the openapi definition with new version\n3. Commit and push changes to GitHub\n4. Wait till CI is green\n5. Tag and push the commit created in step 1. A GitHub actions workflow will automatically deploy the artifacts to Maven Central.\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonallux%2Fspotify-web-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsonallux%2Fspotify-web-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonallux%2Fspotify-web-api/lists"}