Константы и типы

BodyKind

type BodyKind int

Тип тела запроса, используется в WithBody для указания формата тела.

Константа	Значение	Описание	Content-Type
BodyAuto	0	Автоопределение	По типу данных
BodyJSON	1	Принудительный JSON	application/json
BodyXML	2	Принудительный XML	application/xml
BodyForm	3	Форма	application/x-www-form-urlencoded
BodyBinary	4	Бинарный	application/octet-stream
BodyMultipart	5	Multipart	multipart/form-data

Правила автоопределения BodyAuto

Тип входных данных	Content-Type
string	text/plain; charset=utf-8
[]byte	application/octet-stream
*FormData	multipart/form-data
io.Reader	не устанавливается
map[string]string	application/x-www-form-urlencoded
Другие типы	application/json

// Автоопределение (по умолчанию)
result, _ := client.Post(url, httpc.WithBody(data))

// Принудительный JSON
result, _ := client.Post(url, httpc.WithBody(data, httpc.BodyJSON))

// Принудительный XML
result, _ := client.Post(url, httpc.WithBody(data, httpc.BodyXML))

FormData / FileData

FormData

type FormData struct {
    Fields map[string]string
    Files  map[string]*FileData
}

FileData

type FileData struct {
    Filename    string
    Content     []byte
    ContentType string  // MIME-тип, например "image/png", "application/pdf"
}

form := &httpc.FormData{
    Fields: map[string]string{"key": "value"},
    Files: map[string]*httpc.FileData{
        "file": {Filename: "test.txt", Content: []byte("hello"), ContentType: "text/plain"},
    },
}
result, err := client.Post(url, httpc.WithFormData(form))

События аудита

AuditEvent

type AuditEvent struct {
    Timestamp     time.Time           `json:"timestamp"`
    Method        string              `json:"method"`
    URL           string              `json:"url"`           // Маскировано (учётные данные удалены)
    StatusCode    int                 `json:"statusCode"`
    Duration      time.Duration       `json:"duration"`
    Attempts      int                 `json:"attempts"`
    Error         error               `json:"error,omitempty"`
    SourceIP      string              `json:"sourceIP,omitempty"`
    UserID        string              `json:"userID,omitempty"`
    RedirectChain []string            `json:"redirectChain,omitempty"`
    ReqHeaders    map[string][]string `json:"reqHeaders,omitempty"`
    RespHeaders   map[string][]string `json:"respHeaders,omitempty"`
}

AuditMiddlewareConfig

type AuditMiddlewareConfig struct {
    Format         string   // "text" или "json"
    IncludeHeaders bool     // Включать заголовки запроса/ответа
    MaskHeaders    []string // Имена заголовков для маскировки
    SanitizeError  bool     // Маскировать информацию об ошибках
}

Ключи контекста

Константа	Тип	Описание
SourceIPKey	auditContextKey	Исходный IP в событии аудита
UserIDKey	auditContextKey	Идентификатор пользователя в событии аудита

// Передача информации аудита через context
ctx := context.WithValue(context.Background(), httpc.SourceIPKey, "192.168.1.1")
ctx = context.WithValue(ctx, httpc.UserIDKey, "user-123")

// Настройка промежуточного ПО аудита в Config
cfg := httpc.DefaultConfig()
cfg.Middleware.Middlewares = []httpc.MiddlewareFunc{
    httpc.AuditMiddleware(func(event httpc.AuditEvent) {
        fmt.Println(event.SourceIP) // 192.168.1.1
        fmt.Println(event.UserID)   // user-123
    }),
}
client, _ := httpc.New(cfg)

// Значения из context будут прочитаны промежуточным ПО при отправке запроса
result, err := client.Request(ctx, "GET", url)

См. также

• Типы ошибок - полный справочник ClientError, ErrorType и переменных ошибок
• Параметры запроса - использование BodyKind в WithBody
• Промежуточное ПО - AuditMiddleware и конфигурация аудита