Что такое REST API простыми словами: полное руководство 2025

Задача: Опубликовать твит

POST https://api.twitter.com/2/tweets
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "text": "Изучаю REST API! 🚀 #learning"
}

Ответ сервера:

{
  "data": {
    "id": "1234567890123456789",
    "text": "Изучаю REST API! 🚀 #learning",
    "created_at": "2025-10-12T10:30:00.000Z"
  }
}

Что произошло: Ваш твит создан, получил уникальный ID, и теперь все могут его видеть.

Задача: Получить информацию о репозитории

GET https://api.github.com/repos/facebook/react

Ответ сервера (сокращенно):

{
  "name": "react",
  "full_name": "facebook/react",
  "description": "A declarative, efficient, and flexible JavaScript library",
  "stars": 218000,
  "forks": 45000,
  "language": "JavaScript",
  "open_issues": 1234,
  "created_at": "2013-05-24T16:15:54Z"
}

Эти данные используются на странице репозитория GitHub для отображения статистики.

Задача: Узнать погоду в Москве

GET https://api.openweathermap.org/data/2.5/weather?q=Moscow&appid=YOUR_API_KEY&units=metric

Ответ:

{
  "name": "Moscow",
  "main": {
    "temp": 5,
    "feels_like": 2,
    "humidity": 75
  },
  "weather": [
    {
      "main": "Clouds",
      "description": "overcast clouds"
    }
  ],
  "wind": {
    "speed": 4.5
  }
}

Ваше приложение погоды использует эти данные для отображения: "Москва, +5°C, облачно, ветер 4.5 м/с".

Задача: Создать платеж

POST https://api.stripe.com/v1/charges
Authorization: Bearer sk_test_YOUR_SECRET_KEY
Content-Type: application/x-www-form-urlencoded

amount=2000¤cy=usd&source=tok_visa&description=Order #1234

Ответ:

{
  "id": "ch_1234567890",
  "object": "charge",
  "amount": 2000,
  "currency": "usd",
  "status": "succeeded",
  "paid": true
}

Платеж на $20.00 прошел успешно. Интернет-магазин может теперь отправлять товар.

Пример JSON:

{
  "name": "John Doe",
  "age": 30,
  "isStudent": false,
  "email": "john@example.com",
  "hobbies": ["reading", "coding", "gaming"],
  "address": {
    "city": "New York",
    "country": "USA"
  }
}

Работа с JSON в разных языках

JavaScript:

// Превратить JSON строку в объект
const data = JSON.parse('{"name": "John", "age": 30}');
console.log(data.name); // "John"

// Превратить объект в JSON строку
const jsonString = JSON.stringify({name: "John", age: 30});
console.log(jsonString); // '{"name":"John","age":30}'

Python:

import json

# Превратить JSON строку в словарь
data = json.loads('{"name": "John", "age": 30}')
print(data["name"])  # "John"

# Превратить словарь в JSON строку
json_string = json.dumps({"name": "John", "age": 30})
print(json_string)  # '{"name": "John", "age": 30}'

Что это:

Уникальная строка, которую вы добавляете к каждому запросу.

Пример:

GET https://api.example.com/users?api_key=abc123xyz456

Или в заголовке:

GET /api/users
X-API-Key: abc123xyz456

Плюсы: Просто
Минусы: Если кто-то украдет ключ, он получит полный доступ

Что это:

После входа (login) сервер выдает вам токен. Вы добавляете его в заголовок Authorization.

Пример:

Шаг 1: Вход (получение токена)

POST /api/login
Content-Type: application/json

{
  "email": "john@example.com",
  "password": "securepass123"
}

Ответ сервера:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600
}

Шаг 2: Использование токена в запросах

GET /api/profile
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Что это:

Сложный, но самый безопасный метод. Используется крупными сервисами (Google, Facebook, GitHub).

Как это работает:

1. Пользователь нажимает "Войти через Google"
2. Перенаправляется на страницу Google для входа
3. Google выдает временный код
4. Ваше приложение обменивает код на access token
5. Используете access token для запросов к API

Плюсы: Очень безопасно, пользователь не передает пароль вашему приложению
Минусы: Сложная настройка

describe('User API Tests', () => {
  test('GET /api/users should return list of users', async () => {
    const response = await fetch('https://api.example.com/users');
    const data = await response.json();
    
    // Проверяем статус код
    expect(response.status).toBe(200);
    
    // Проверяем, что вернулся массив
    expect(Array.isArray(data)).toBe(true);
    
    // Проверяем структуру первого пользователя
    expect(data[0]).toHaveProperty('id');
    expect(data[0]).toHaveProperty('name');
    expect(data[0]).toHaveProperty('email');
  });

  test('POST /api/users should create new user', async () => {
    const newUser = {
      name: 'Test User',
      email: 'test@example.com'
    };
    
    const response = await fetch('https://api.example.com/users', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(newUser)
    });
    
    const data = await response.json();
    
    // Проверяем статус
    expect(response.status).toBe(201);
    
    // Проверяем, что вернулся ID
    expect(data).toHaveProperty('id');
    expect(data.name).toBe('Test User');
  });

  test('GET /api/users/999999 should return 404', async () => {
    const response = await fetch('https://api.example.com/users/999999');
    expect(response.status).toBe(404);
  });
});

Что это:

GUI приложение для тестирования API. Позволяет отправлять запросы, сохранять коллекции, автоматизировать тесты.

Возможности:

• ✅ Отправка GET, POST, PUT, DELETE запросов
• ✅ Сохранение коллекций запросов
• ✅ Переменные окружения (dev, staging, prod)
• ✅ Автоматические тесты (JavaScript)
• ✅ Генерация документации
• ✅ Командная работа (Postman Teams)

Скачать: postman.com

Что это:

Утилита командной строки для отправки HTTP запросов. Работает везде (Linux, Mac, Windows).

Примеры команд:

# GET запрос
curl https://api.example.com/users

# POST запрос с JSON
curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

# С авторизацией
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.example.com/profile

# Вывести заголовки ответа
curl -i https://api.example.com/users

# Сохранить ответ в файл
curl -o response.json https://api.example.com/users

Что это:

Библиотека Java для автоматизации тестирования REST API.

Пример теста:

import static io.restassured.RestAssured.*;
import static org.hamcrest.Matchers.*;

@Test
public void testGetUsers() {
    given()
        .baseUri("https://api.example.com")
    .when()
        .get("/users")
    .then()
        .statusCode(200)
        .body("size()", greaterThan(0))
        .body("[0].name", notNullValue());
}

Что это:

Самая популярная библиотека Python для работы с HTTP.

Пример:

import requests

# GET запрос
response = requests.get('https://api.example.com/users')
print(response.status_code)  # 200
print(response.json())  # Парсит JSON автоматически

# POST запрос
new_user = {"name": "John", "email": "john@example.com"}
response = requests.post(
    'https://api.example.com/users',
    json=new_user,
    headers={"Authorization": "Bearer YOUR_TOKEN"}
)
print(response.json())

Что это:

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

Пример: petstore.swagger.io