クイックスタート

インストール

go get github.com/cybergodev/httpc

基本的なリクエスト

クライアントを作成せず、パッケージレベル関数を直接使用します：

package main

import (
    "fmt"
    "log"

    "github.com/cybergodev/httpc"
)

func main() {
    result, err := httpc.Get("https://httpbin.org/get")
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(result.StatusCode()) // 200
    fmt.Println(result.Body())       // レスポンス内容
}

対応 HTTP メソッド：Get、Post、Put、Patch、Delete、Head、Options。

クライアントの作成

カスタム設定が必要な場合は、クライアントインスタンスを作成します：

client, err := httpc.New()
if err != nil {
    log.Fatal(err)
}
defer client.Close()

result, err := client.Get("https://httpbin.org/get")

設定プリセット

設定	用途	特徴
DefaultConfig()	汎用シナリオ	安全なデフォルト値、SSRF 防護有効
SecureConfig()	セキュリティ重視シナリオ	自動リダイレクト無効、厳格なタイムアウト
PerformanceConfig()	高スループットシナリオ	大規模コネクションプール、長いタイムアウト、Cookie 有効
TestingConfig()	テスト環境	セキュリティ検査・HTTP/2 無効化、Cookie 有効化
MinimalConfig()	軽量リクエスト	リトライなし、リダイレクトなし

cfg := httpc.DefaultConfig()
cfg.Timeouts.Request = 60 * time.Second

client, err := httpc.New(cfg)

レスポンス処理

result, err := client.Get("https://httpbin.org/json")
if err != nil {
    log.Fatal(err)
}

// ステータス確認
result.StatusCode()     // 200
result.IsSuccess()      // true (2xx)
result.IsClientError()  // false (4xx)
result.IsServerError()  // false (5xx)

// JSON 解析
var data map[string]any
if err := result.Unmarshal(&data); err != nil {
    log.Fatal(err)
}

データの送信

// JSON
result, err := client.Post("https://httpbin.org/post",
    httpc.WithJSON(map[string]any{"name": "test"}),
)

// フォーム
result, err := client.Post("https://httpbin.org/post",
    httpc.WithForm(map[string]string{"username": "admin"}),
)

// 認証付き
result, err := client.Get("https://api.example.com/data",
    httpc.WithBearerToken("my-token"),
)

エラー処理

HTTPC はネットワーク層エラーと HTTP ステータスコードを区別します：

result, err := client.Get("https://api.example.com/data")
if err != nil {
    var clientErr *httpc.ClientError
    if errors.As(err, &clientErr) {
        log.Printf("エラーコード: %s", clientErr.Code())
    }
    log.Fatal(err)
}

// HTTP ステータスコードは手動で確認
switch {
case result.IsSuccess():
    // 2xx 成功
case result.IsClientError():
    log.Printf("クライアントエラー: %d", result.StatusCode())
case result.IsServerError():
    log.Printf("サーバーエラー: %d", result.StatusCode())
}

TIP

4xx/5xx は error として返されません。result.IsSuccess() などのメソッドで確認してください。詳しくは エラー処理 をご覧ください。

次のステップ

• チュートリアル - 30 分で GitHub API クライアントを構築
• リクエストとレスポンス - 完全なリクエストオプションとレスポンス処理
• 基本例 - GET/POST/ミドルウェアなどの実例
• チートシート - よく使う操作のクイックリファレンス
• セキュリティ - セキュリティベストプラクティス