networkinkt 
This is a lightweight HTTP client for Kotlin. It relies on coroutines on both JS & JVM platforms.
Here is a simple GET request:
val text = HTTP.get("http://httpbin.org/status/200").getText() // suspending call
...and a POST request with HTTP headers and body:
val text = HTTP.post("http://httpbin.org/headers",
headers = mapOf("MyLibraryHeader" to "networkinkt"),
body = "param=value")
.getText()
See the usage section for more examples.
Getting started
The project uses Gradle to manage dependencies.
Common JVM & JS build.gradle:
allprojects {
repositories {
// ...
maven { url 'https://jitpack.io' }
}
}
dependencies {
// ...
compile "com.egorzh.networkinkt:networkinkt:$networkinkt_version"
}
yourproject-jvm/build.gradle:
dependencies {
// ...
compile "com.egorzh.networkinkt:networkinkt-jvm:$networkinkt_version"
}
yourproject-js/build.gradle:
dependencies {
// ...
compile "com.egorzh.networkinkt:networkinkt-js:$networkinkt_version"
}
You can always check which version is up-to-date on the releases page
Usage
How to make a request:
- Obtain an instance of
HTTPRequestfrom anHTTPClient(the default one isDefaultHTTPClientor simplyHTTP) - Send the request and receive an
HTTPResponse, which encapsulates the response code and text - Use
codeandtextproperties of a response object
import com.egorzh.networkinkt.*
// 1:
val request /* : DefaultHTTPRequest */ = HTTP.get(url = "http://httpbin.org/status/200")
// 2: (from a suspend function or coroutine)
val response /* : DefaultHTTPResponse */ = HTTP.sendRequest(request)
// 3:
val code = response.code
val text = response.text
Customization
You can easily create your own implementations of HTTPClient, for example, to provide caching or error handling functionality.
Apache adapter is an example of using custom HTTPClient.
2.4k Dec 24, 2022
2 Sep 1, 2022
9 Nov 15, 2022
174 Nov 28, 2022
466 Dec 20, 2022
4.3k Jan 8, 2023
4 Dec 23, 2022
0 Jun 3, 2022
750 Dec 29, 2022
829 Dec 29, 2022
13 Sep 30, 2022
7.3k Jan 2, 2023
12 Aug 5, 2022
461 Dec 13, 2022
6k Jan 8, 2023
43.4k Jan 5, 2023
2.4k Jan 5, 2023
15 Mar 29, 2020