# Introduction ![](https://repository-images.githubusercontent.com/141764280/12771480-a7f9-11e9-8a41-4a1280106f8a) [![Build Status](https://travis-ci.org/rybalkinsd/kohttp.svg?branch=master)](https://travis-ci.org/rybalkinsd/kohttp) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.github.rybalkinsd/kohttp/badge.svg)](https://maven-badges.herokuapp.com/maven-central/io.github.rybalkinsd/kohttp) [![codecov](https://codecov.io/gh/rybalkinsd/kohttp/branch/master/graph/badge.svg)](https://codecov.io/gh/rybalkinsd/kohttp) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/e072bcbe3dcf4fce87e44443f0721537)](https://www.codacy.com/app/yan.brikl/kohttp?utm_source=github.com\&utm_medium=referral\&utm_content=rybalkinsd/kohttp\&utm_campaign=Badge_Grade) [![Kotlin](https://img.shields.io/badge/Kotlin-1.3.50-blue.svg)](https://kotlinlang.org) [![Awesome Kotlin Badge](https://kotlin.link/awesome-kotlin.svg)](https://github.com/KotlinBy/awesome-kotlin) [![Join the chat at https://gitter.im/kohttp/community](https://badges.gitter.im/kohttp/community.svg)](https://gitter.im/kohttp/community?utm_source=badge\&utm_medium=badge\&utm_campaign=pr-badge\&utm_content=badge)[![star this repo](http://githubbadges.com/star.svg?user=rybalkinsd\&repo=kohttp\&style=flat)](https://github.com/rybalkinsd/kohttp) Kotlin DSL http client ## Features 🔹 Developers Experience-driven library without verbosity. 🔹 Native way to use http client in Kotlin. 🔹 HTTP [`GET`](https://kohttp.gitbook.io/docs/core/synchronous-calls/get)/[`POST`](https://kohttp.gitbook.io/docs/core/synchronous-calls/post)/[`PUT`](https://kohttp.gitbook.io/docs/core/synchronous-calls/put)/[`HEAD`](https://kohttp.gitbook.io/docs/core/synchronous-calls/head)/[`DELETE`](https://kohttp.gitbook.io/docs/core/synchronous-calls/delete)/[`PATCH`](https://kohttp.gitbook.io/docs/core/synchronous-calls/patch) requests. 🔹 [Asynchronous](https://kohttp.gitbook.io/docs/core/asynchronous-calls) and [blocking](https://kohttp.gitbook.io/docs/core/synchronous-calls) requests. 🔹 [Upload files](https://kohttp.gitbook.io/docs/core/synchronous-calls/upload-files). 🔹 [Logging](https://kohttp.gitbook.io/docs/core/interceptors#logging-interceptor-a-request-logging-interceptor) - easily dump your http requests or convert them to cURL commands. 🔹 Minimal footprint. ## Quick start ```kotlin // Use String or URL extensions send simple request val response = "https://my-host.com/users?admin=true".httpGet() // Parse response with your favorite library val users = response.toJson() // Use sync or async methods to send your requests // Configure method params, headers, cookies and body in a concise way val notifications: List> = users.forEach { user -> httpPostAsync { url("https://my-host.com/friends/push") param { "userId" to user[id] "eventType" to NewFriend } header { "locale" to "en_EN" cookie { "user_session" to "toFycNV" "authToken" to "d2dwa6011w96c93ct3e3493d4a1b5c8751563217409" } } } } ``` ## Samples * [Android application](https://github.com/rybalkinsd/kohttp/tree/031d8b35d44233c6f3abc93b8d99cb69a92790cd/samples/android/README.md) * [Spring Boot application](https://github.com/rybalkinsd/kohttp/tree/031d8b35d44233c6f3abc93b8d99cb69a92790cd/samples/spring/README.md) ## About kohttp * [Kotlin weekly](https://mailchi.mp/kotlinweekly/kotlin-weekly-124) mentioned us * [Android weekly (CN)](https://androidweekly.io/android-dev-weekly-issue-208/) mentioned us * [Kotlin http client. Making kohttp 0.11.0](https://medium.com/@sergei.rybalkin/kotlin-http-client-making-kohttp-0-11-0-af16fb702c86?source=friends_link\&sk=e0284c5f8028034eafd433ff5fcfcf47) - medium post * [Write your Android network as Kotlin DSL](https://medium.com/datadriveninvestor/write-your-android-networking-as-a-kotlin-dsl-330febae503f) - medium post * [Upload files to Google Drive with Kotlin](https://medium.com/@sergei.rybalkin/upload-file-to-google-drive-with-kotlin-931cec5252c1) - medium post * [Production Kotlin DSL (RU + subtitles) ](https://youtu.be/4m9bS0M0Nww) - Kotlin/Everywhere talk, YouTube ## Installation ### Gradle Kotlin DSL: ```kotlin implementation(group = "io.github.rybalkinsd", name = "kohttp", version = "0.12.0") ``` Groovy DSL: ```groovy implementation 'io.github.rybalkinsd:kohttp:0.12.0' ``` ### Maven: ```markup io.github.rybalkinsd kohttp 0.12.0 ``` ## Table of contents * [Synchronous calls](https://kohttp.gitbook.io/docs/core/synchronous-calls) * [GET](https://kohttp.gitbook.io/docs/core/synchronous-calls/get) * [POST](https://kohttp.gitbook.io/docs/core/synchronous-calls/post) * [PUT](https://kohttp.gitbook.io/docs/core/synchronous-calls/put) * [HEAD](https://kohttp.gitbook.io/docs/core/synchronous-calls/head) * [DELETE](https://kohttp.gitbook.io/docs/core/synchronous-calls/delete) * [PATCH](https://kohttp.gitbook.io/docs/core/synchronous-calls/patch) * [Upload files](https://kohttp.gitbook.io/docs/core/synchronous-calls/upload-files) * [Generic requests](https://kohttp.gitbook.io/docs/core/synchronous-calls/generic-requests) * [Asynchronous calls](https://kohttp.gitbook.io/docs/core/asynchronous-calls) * [async GET](https://kohttp.gitbook.io/docs/core/asynchronous-calls/async-get) * [async POST](https://kohttp.gitbook.io/docs/core/asynchronous-calls/async-post) * [async PUT](https://kohttp.gitbook.io/docs/core/asynchronous-calls/async-put) * [async HEAD](https://kohttp.gitbook.io/docs/core/asynchronous-calls/async-head) * [async DELETE](https://kohttp.gitbook.io/docs/core/asynchronous-calls/async-delete) * [async PATCH](https://kohttp.gitbook.io/docs/core/asynchronous-calls/async-patch) * [async Upload files](https://kohttp.gitbook.io/docs/core/asynchronous-calls/async-upload-files) * [async Generic requests](https://kohttp.gitbook.io/docs/core/asynchronous-calls/generic-requests) * [Response usage](https://kohttp.gitbook.io/docs/core/response-usage) * [Interceptors](https://kohttp.gitbook.io/docs/core/interceptors) * [Customisation](https://kohttp.gitbook.io/docs/core/customisation) * [Experimental features](https://kohttp.gitbook.io/docs/core/experimental-features) * [Changelog](https://kohttp.gitbook.io/docs/history/changelog)