---
sidebar_label: "クイックスタート"
title: "クイックスタート - CyberGo HTTPC | 5 分ガイド"
description: "HTTPC クイックスタート：go get インストールと初期化、GET/POST リクエストとレスポンス処理、5 つの設定プリセット選択、JSON 解析、Bearer Token 認証で 5 分で安全な HTTP クライアントを始め、最初のリクエストを完成させます。"
sidebar_position: 1
---

# クイックスタート

## インストール

```bash
go get github.com/cybergodev/httpc
```

## 基本的なリクエスト

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

```go
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`。

## クライアントの作成

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

```go
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()` | 軽量リクエスト | リトライなし、リダイレクトなし |

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

client, err := httpc.New(cfg)
```

## レスポンス処理

```go
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)
}
```

## データの送信

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

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

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

## エラー処理

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

```go
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()` などのメソッドで確認してください。詳しくは [エラー処理](../advanced/error-handling) をご覧ください。
:::

## 次のステップ

- **[チュートリアル](../guides/tutorial)** - 30 分で GitHub API クライアントを構築
- **[リクエストとレスポンス](../guides/request-response)** - 完全なリクエストオプションとレスポンス処理
- **[基本例](../examples/basic-usage)** - GET/POST/ミドルウェアなどの実例
- **[チートシート](./cheatsheet)** - よく使う操作のクイックリファレンス
- **[セキュリティ](../security/)** - セキュリティベストプラクティス