Какие инструменты и подходы используются для тестирования HTTP API в Go?

Тестирование HTTP API — ключевая часть бэкенд-разработки. Для этого в Go и смежных областях применяют несколько подходов и инструментов, которые можно разделить на три основные категории:

1. Стандартная библиотека Go (net/http/httptest)

Это основной способ для написания автоматических unit- и интеграционных тестов внутри вашего Go-проекта. Пакет httptest позволяет имитировать HTTP-запросы и записывать ответы без реального сетевого взаимодействия.

• httptest.NewRecorder: Записывает ответ от вашего хендлера.
• httptest.NewRequest: Создает мок-запрос для передачи в хендлер.

Пример теста для HTTP-хендлера:

// handler_test.go
package main

import (
    "io"
    "net/http"
    "net/http/httptest"
    "testing"
)

// Тестируемый хендлер
func MyHandler(w http.ResponseWriter, r *http.Request) {
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("OK"))
}

func TestMyHandler(t *testing.T) {
    // Создаем мок-запрос
    req := httptest.NewRequest(http.MethodGet, "/", nil)

    // Создаем рекордер для записи ответа
    w := httptest.NewRecorder()

    // Вызываем хендлер
    MyHandler(w, req)

    // Получаем результат
    resp := w.Result()
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)

    // Проверяем статус-код и тело ответа
    if resp.StatusCode != http.StatusOK {
        t.Errorf("expected status %d; got %d", http.StatusOK, resp.StatusCode)
    }
    if string(body) != "OK" {
        t.Errorf("expected body 'OK'; got '%s'", string(body))
    }
}

2. Утилиты командной строки (CLI)

Используются для быстрой ручной проверки эндпоинтов, написания скриптов и интеграции в CI/CD.

• curl: Стандарт де-факто для выполнения HTTP-запросов из терминала. Гибкий и мощный инструмент.
• httpie: Более современная и user-friendly альтернатива curl с подсветкой синтаксиса и более простым интерфейсом.

3. Графические клиенты (GUI)

Идеальны для ручного тестирования, исследования API, создания коллекций запросов и совместной работы в команде.

• Postman: Самый популярный инструмент. Позволяет создавать сложные запросы, управлять окружениями (dev, prod), писать тесты на JavaScript и создавать документацию.
• Insomnia: Прямой конкурент Postman, ценится за более чистый интерфейс и хорошую поддержку GraphQL.