11# Kotlin Spotify Web API
2+ A [ Kotlin] ( https://kotlinlang.org/ ) implementation of the [ Spotify Web API] ( https://developer.spotify.com/web-api/ ) ,
3+ supporting Kotlin/JS, Kotlin/Android, Kotlin/JVM, and Kotlin/Native
4+ (macOS, Windows, Linux).
5+
26[ ![ JCenter] ( https://maven-badges.herokuapp.com/maven-central/com.adamratzman/spotify-api-kotlin/badge.svg )] ( https://maven-badges.herokuapp.com/maven-central/com.adamratzman/spotify-api-kotlin )
3- [ ![ Build Status] ( http://144.217.240.243:8111/app/rest/builds/aggregated/strob:(buildType:(project:(id:SpotifyWebApiKotlin)))/statusIcon.svg )] ( http://144.217.240.243:8111/project.html?projectId=SpotifyWebApiKotlin )
4- [ ![ ] ( https://img.shields.io/badge/Documentation-latest-orange.svg )] ( https://adamint.github.io/spotify-web-api-kotlin/spotify-web-api-kotlin/ )
7+ [ ![ ] ( https://img.shields.io/badge/Documentation-latest-orange.svg )] ( https://adamint.github.io/spotify-web-api-kotlin-docs/spotify-web-api-kotlin/ )
58![ ] ( https://img.shields.io/badge/License-MIT-blue.svg )
69
7- This is the [ Kotlin] ( https://kotlinlang.org/ ) implementation of the [ Spotify Web API] ( https://developer.spotify.com/web-api/ )
10+
11+ ![ Android Tests] ( https://img.shields.io/teamcity/build/s/SpotifyWebApiKotlin_AndroidTests?label=Kotlin%2FAndroid%20Tests&server=https%3A%2F%2Fadam.beta.teamcity.com )
12+ ![ JS tests Status] ( https://img.shields.io/teamcity/build/s/SpotifyWebApiKotlin_JsTests?label=Kotlin%2FJS%20Tests&server=https%3A%2F%2Fadam.beta.teamcity.com )
13+ ![ JVM tests] ( https://img.shields.io/teamcity/build/s/SpotifyWebApiKotlin_JvmTests?label=Kotlin%2FJVM%20Tests&server=https%3A%2F%2Fadam.beta.teamcity.com )
14+ ![ Linux Tests] ( https://img.shields.io/teamcity/build/s/SpotifyWebApiKotlin_LinuxTests?label=Kotlin%2FLinux%20Tests&server=https%3A%2F%2Fadam.beta.teamcity.com )
15+ ![ macOS Tests] ( https://img.shields.io/teamcity/build/s/SpotifyWebApiKotlin_RunTestsMac?label=Kotlin%2FmacOS%20Tests&server=https%3A%2F%2Fadam.beta.teamcity.com )
816
917## Table of Contents
1018* [ Library installing] ( #library-installing )
11- + [ JVM, Android, JS] ( #jvm-android-js )
19+ + [ JVM, Android, JS, Native ] ( #jvm-android-js )
1220 + [ Android information] ( #android )
1321* [ Documentation] ( #documentation )
1422* [ Need help, have a question, or want to contribute?] ( #have-a-question )
@@ -24,20 +32,23 @@ This is the [Kotlin](https://kotlinlang.org/) implementation of the [Spotify Web
2432* [ Tips] ( #tips )
2533 + [ Building the API] ( #building-the-api )
2634* [ Notes] ( #notes )
27- + [ The benefits of LinkedResults, PagingObjects, and Cursor-based Paging Objects] ( #the-benefits-of-linkedresults-pagingobjects-and-cursor-based-paging-objects )
35+ + [ LinkedResults, PagingObjects, and Cursor-based Paging Objects] ( #the-benefits-of-linkedresults-pagingobjects-and-cursor-based-paging-objects )
2836 + [ Generic Requests] ( #generic-request )
2937 + [ Track Relinking] ( #track-relinking )
3038* [ Contributing] ( #contributing )
3139
3240## Library installing
41+ Current version:
42+
43+ [ ![ JCenter] ( https://maven-badges.herokuapp.com/maven-central/com.adamratzman/spotify-api-kotlin/badge.svg )] ( https://maven-badges.herokuapp.com/maven-central/com.adamratzman/spotify-api-kotlin )
3344
34- ### JVM, Android, JS
45+ ### JVM, Android, JS, Native (macOS, Windows, Linux)
3546```
3647repositories {
3748 jcenter()
3849}
3950
40- implementation("com.adamratzman:spotify-api-kotlin-core:3.4.03 ")
51+ implementation("com.adamratzman:spotify-api-kotlin-core:VERSION ")
4152```
4253
4354### Android
@@ -138,7 +149,7 @@ The `SpotifyClientApi` is a superset of `SpotifyApi`; thus, nothing changes if y
138149access public data.
139150This library does not provide a method to retrieve the code from your callback url; instead,
140151you must implement that with a web server.
141- Automatic refresh is available * only* when building with an authorization code or a
152+ Automatic Token refresh is available * only* when building with an authorization code or a
142153` Token ` object. Otherwise, it will expire ` Token.expiresIn ` seconds after creation.
143154
144155Make sure your application has requested the proper [ Scopes] ( https://developer.spotify.com/web-api/using-spotifyScopes/ ) in order to
@@ -371,7 +382,7 @@ runBlocking {
371382```
372383
373384## Notes
374- ### The benefits of LinkedResults, PagingObjects, and Cursor-based Paging Objects
385+ ### LinkedResults, PagingObjects, and Cursor-based Paging Objects
375386Spotify provides these three object models in order to simplify our lives as developers. So let's see what we
376387can do with them!
377388
0 commit comments