1
1
# 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
+
2
6
[ ![ 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/ )
5
8
![ ] ( https://img.shields.io/badge/License-MIT-blue.svg )
6
9
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 )
8
16
9
17
## Table of Contents
10
18
* [ Library installing] ( #library-installing )
11
- + [ JVM, Android, JS] ( #jvm-android-js )
19
+ + [ JVM, Android, JS, Native ] ( #jvm-android-js )
12
20
+ [ Android information] ( #android )
13
21
* [ Documentation] ( #documentation )
14
22
* [ 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
24
32
* [ Tips] ( #tips )
25
33
+ [ Building the API] ( #building-the-api )
26
34
* [ 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 )
28
36
+ [ Generic Requests] ( #generic-request )
29
37
+ [ Track Relinking] ( #track-relinking )
30
38
* [ Contributing] ( #contributing )
31
39
32
40
## 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 )
33
44
34
- ### JVM, Android, JS
45
+ ### JVM, Android, JS, Native (macOS, Windows, Linux)
35
46
```
36
47
repositories {
37
48
jcenter()
38
49
}
39
50
40
- implementation("com.adamratzman:spotify-api-kotlin-core:3.4.03 ")
51
+ implementation("com.adamratzman:spotify-api-kotlin-core:VERSION ")
41
52
```
42
53
43
54
### Android
@@ -138,7 +149,7 @@ The `SpotifyClientApi` is a superset of `SpotifyApi`; thus, nothing changes if y
138
149
access public data.
139
150
This library does not provide a method to retrieve the code from your callback url; instead,
140
151
you 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
142
153
` Token ` object. Otherwise, it will expire ` Token.expiresIn ` seconds after creation.
143
154
144
155
Make sure your application has requested the proper [ Scopes] ( https://developer.spotify.com/web-api/using-spotifyScopes/ ) in order to
@@ -371,7 +382,7 @@ runBlocking {
371
382
```
372
383
373
384
## Notes
374
- ### The benefits of LinkedResults, PagingObjects, and Cursor-based Paging Objects
385
+ ### LinkedResults, PagingObjects, and Cursor-based Paging Objects
375
386
Spotify provides these three object models in order to simplify our lives as developers. So let's see what we
376
387
can do with them!
377
388
0 commit comments