# LianjiaTech/retrofit-spring-boot-starter

A spring-boot starter for retrofit, supports rapid integration and feature enhancements.（适用于retrofit的spring-boot-starter，支持快速集成和功能增强）

Repository: https://github.com/LianjiaTech/retrofit-spring-boot-starter
Canonical: https://ross.abutalabs.com/products/retrofit-spring-boot-starter
Language: Java
License: Apache-2.0
License Family: permissive
Topics: java, retrofit, http, okhttp3, spring-boot
Last push: 2026-08-08T06:41:14+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 96, longevity 100
- inputs: {"age_days": 2343, "days_push": 25, "days_rel": 25, "gap_med": 0, "n_releases_24m": 24}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1911, forks 340 (observed 2026-08-28T04:05:53.230512+00:00)

## What it is
A Spring Boot starter that deeply integrates the Retrofit declarative HTTP client into Spring Boot applications, letting developers define HTTP APIs as annotated Java interfaces and inject them as beans. It adds feature enhancements such as auto-scanning of @RetrofitClient interfaces and extended configuration on top of Retrofit and OkHttp.

## Use cases
- call external http apis from a spring boot service
- define http clients as java interfaces with retrofit
- quickly integrate retrofit into spring boot
- declarative http client with retry and error handling in java
- inject retrofit interfaces as spring beans
- replace manual okhttp/resttemplate boilerplate in spring boot

## When to choose
- you are building a Spring Boot (Java) app that consumes remote HTTP APIs
- you want Retrofit's declarative interface style with Spring dependency injection
- you want starter conveniences like component scanning, interceptors, and converters configured out of the box

## When to avoid
- your project is not on the JVM or does not use Spring
- you need a reactive/WebFlux-first HTTP client rather than Retrofit's blocking model
- you only need a one-off raw HTTP call where a plain OkHttp or RestTemplate client suffices

## Facets
- artifact type: library
- maturity: active
- function: http-client, api-framework, middleware
- domain: backend, web-development, apis, developer-tools
- platform: jvm
- tags: retrofit, okhttp, spring-boot-starter, declarative-http, java, spring-boot

## Member repositories
- LianjiaTech/retrofit-spring-boot-starter (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:53.230512+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:10:39.984795+00:00, confidence not recorded.
  - readme: https://github.com/LianjiaTech/retrofit-spring-boot-starter (fetched 2026-08-28T04:05:53.230512+00:00, sha 3e842f057714)
- Data as of 2026-08-30T08:39:29.467469+00:00.