http_client

Okapi HTTP Client (okapi/client package)

github.com/jkaninda/okapi/client is a small fluent HTTP client with:

• A request builder per verb
• Default + per-request middleware chain
• Built-in retry policy with exponential backoff
• Body encoders for JSON, XML, YAML, form, multipart, raw
• Response decoders driven by Content-Type
• Zero dependency on the Okapi server package — usable against any REST API

Quick Start

import "github.com/jkaninda/okapi/client"

c := client.New("https://api.example.com",
    client.WithBearerToken(token),
    client.WithUserAgent("my-app/1.0"),
    client.WithTimeout(10*time.Second),
)

var user User
resp, err := c.Get("/users/42").
    WithContext(ctx).
    QueryParam("expand", "profile").
    Do()
if err != nil { return err }
if err := resp.Error(); err != nil { return err } // *client.HTTPError on non-2xx
if err := resp.JSON(&user); err != nil { return err }

Do() and Send() are aliases. For the common "do, decode, fail on non-2xx" path use Decode:

var user User
err := c.Get("/users/42").Decode(&user)

Decode chooses JSON / XML / YAML based on the response Content-Type.

Client Options

Option	Purpose
WithHTTPClient(*http.Client)	Provide a pre-configured http.Client (TLS, transport)
WithTimeout(d)	Default per-request timeout
WithHeader(k, v)	Add one default header
WithHeaders(map)	Merge multiple default headers
WithBearerToken(token)	Sets Authorization: Bearer <token>
WithBasicAuth(u, p)	Sets Authorization: Basic ...
WithUserAgent(ua)	Sets the default User-Agent
WithMiddleware(mw...)	Append middleware to the chain
WithRetry(policy)	Default retry policy

Request Builder

Each verb returns a *RequestBuilder:

resp, err := c.Post("/items").
    WithContext(ctx).
    Header("X-Trace-Id", traceID).
    QueryParam("dry_run", "true").
    JSONBody(Item{Title: "hello"}).
    Timeout(5*time.Second).
    Do()