https://github.com/square/retrofit

A type-safe HTTP client for Android and the JVM
https://github.com/square/retrofit

android java

Last synced: 2 months ago
JSON representation

A type-safe HTTP client for Android and the JVM

• Host: GitHub
• URL: https://github.com/square/retrofit
• Owner: square
• License: apache-2.0
• Created: 2010-09-06T21:39:43.000Z (about 15 years ago)
• Default Branch: trunk
• Last Pushed: 2025-09-08T12:10:35.000Z (2 months ago)
• Last Synced: 2025-09-08T14:21:40.525Z (2 months ago)
• Topics: android, java
• Language: HTML
• Homepage: https://square.github.io/retrofit/
• Size: 6.25 MB
• Stars: 43,711
• Watchers: 1,549
• Forks: 7,339
• Open Issues: 160
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

• Awesome-Android-Open-Source-Projects - Retrofit
• Awesome-RxJava - retrofit - 支持RxJava的网络请求库 (Library / 一些原理分析的文章)
• stars - square/retrofit - safe HTTP client for Android and the JVM (HarmonyOS / Windows Manager)
• awesome-android-person - retrofit
• awesome-android-libraries - https://github.com/square/retrofit
• awesome-android - Retrofit - safe HTTP client for Android and Java by Square, Inc. (Libraries / Networking)
• StarryDivineSky - square/retrofit
• awesome-android-ui - https://github.com/square/retrofit
• my-awesome - square/retrofit - 10 star:43.8k fork:7.3k A type-safe HTTP client for Android and the JVM (HTML)
• awesome-open-source-kotlin-applications - Retrofit - safe HTTP client for Android and Java. |  |  |  |  |  | (Android Kotlin Project Showcase)
• useful-java-links - Square Retrofit - safe REST client. License: [Apache 2](http://www.apache.org/licenses/LICENSE-2.0) , [](https://github.com/square/retrofit).  (III. Network and Integration / 5. Rest Frameworks)
• awesome-java - Retrofit

README

          
Retrofit

========

A type-safe HTTP client for Android and Java.

For more information please see [the website][1].

Download

--------

Download [the latest JAR][2] or grab from Maven central at the coordinates `com.squareup.retrofit2:retrofit:3.0.0`.

Snapshots of the development version are available in [Sonatype's `snapshots` repository][snap].

Retrofit requires at minimum Java 8+ or Android API 21+.

R8 / ProGuard

-------------

If you are using R8 the shrinking and obfuscation rules are included automatically.

ProGuard users must manually add the options from

[retrofit2.pro][proguard file].

You might also need [rules for OkHttp][okhttp proguard] which is a dependency of this library.

License

=======

    Copyright 2013 Square, Inc.

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.

 [1]: https://square.github.io/retrofit/

 [2]: https://search.maven.org/remote_content?g=com.squareup.retrofit2&a=retrofit&v=LATEST

 [snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/

 [proguard file]: https://github.com/square/retrofit/blob/master/retrofit/src/main/resources/META-INF/proguard/retrofit2.pro

 [okhttp proguard]: https://square.github.io/okhttp/r8_proguard/

 [okio proguard]: https://square.github.io/okio/#r8-proguard