Быстрый старт

Установка

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() и другие методы. Подробнее см. Обработка ошибок.

Что дальше

• Практическое руководство - создание клиента GitHub API за 30 минут
• Запросы и ответы - полные параметры запросов и обработка ответов
• Базовые примеры - практические примеры GET/POST/промежуточного ПО
• Шпаргалка - быстрый справочник типичных операций
• Безопасность - лучшие практики безопасности