---
sidebar_label: "Быстрый старт"
title: "Быстрый старт - CyberGo HTTPC | За 5 минут"
description: "Быстрый старт HTTPC: установка, запросы GET/POST, обработка ответов, выбор пресета, парсинг JSON и аутентификация Bearer Token за пять минут."
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)** - создание клиента GitHub API за 30 минут
- **[Запросы и ответы](../guides/request-response)** - полные параметры запросов и обработка ответов
- **[Базовые примеры](../examples/basic-usage)** - практические примеры GET/POST/промежуточного ПО
- **[Шпаргалка](./cheatsheet)** - быстрый справочник типичных операций
- **[Безопасность](../security/)** - лучшие практики безопасности