index.md

layout	default
title	KissRequests

KISS Java Libraries

KissRequests

Tiny zero-dependency Java 17+ HTTP client library built on native java.net.http.HttpClient, with prepared calls, curl rendering, retries, and rich error reports.

Latest stable: 0.1.0 Java 17+ Apache-2.0

Getting Started API Reference GitHub

Maven

<dependency>
  <groupId>io.github.arthurhoch</groupId>
  <artifactId>kiss-requests</artifactId>
  <version>0.1.0</version>
</dependency>

Small Surface

KissRequests keeps request construction, execution, debugging, and error handling explicit. It avoids REST framework abstractions while still covering common HTTP workflows.

Quick Example

Http http = Http.create();
HttpResult result = http
    .request(HttpMethod.GET, "https://api.example.com/users")
    .execute();

KISS Principles

Native JDK

The production library builds on Java HttpClient and does not ship external runtime dependencies.

Debuggable Calls

Prepared calls can be rendered as curl, including base64-safe variants for binary bodies.

Useful Failures

Exceptions include method, URL, attempts, timing, status, headers, body, curl, and cause details.

Documentation

Getting StartedInstall and make the first request. API ReferencePublic HTTP API and result types. AI SkillsVersioned Markdown skill files for AI-assisted usage. ExamplesCopyable examples for common calls. ConfigurationTimeouts, retries, concurrency, and executors. Curl DebuggingUse toCurl for reproducible diagnostics. Files And StreamsUpload, download, stream, and multipart usage. Error HandlingHow rich exceptions are structured. Security ScanningCodeQL, Dependabot, Dependency Review, and OWASP. Security HardeningRepository hardening and local quality commands. Secret HygieneRules for credentials and curl output. Safe Code CleanupDeletion policy and quality gates. ReleaseRelease process and Maven Central flow.

Related Projects

kiss-jsonField-based JSON serialization and deserialization. kiss-requestsSimple HTTP client built on Java HttpClient. kiss-serverSmall HTTP/1.1 server for simple REST-style applications. kiss-configConfiguration from properties, .env, system properties, and environment variables. kiss-binaryExplicit binary IO for primitive binary formats.