Серия «Термины вкатура»

🤔 Кто такие "крудошлепы"?

Крудошлеп — это разработчик, который занимается реализацией этих базовых операций, часто без глубокого понимания архитектуры. Такие разработчики могут быть новичками или специализироваться на рутинных задачах, не требующих сложных решений.

👀 Примеры endpoints:

• GET /users — получить список пользователей.

• POST /users — создать нового пользователя.

• PUT /users/{id} — обновить данные пользователя с указанным ID.

• DELETE /users/{id} — удалить пользователя с указанным ID.

🐣 Каждый endpoint имеет:

1. HTTP-метод : GET, POST, PUT, DELETE и другие.

2. Путь (URL) : уникальный адрес, который указывает на конкретный ресурс.

3. Логику обработки : код на сервере, который выполняется при обращении к этому endpoint.

😁 Почему Endpoint Называют "Ручками"?

Термин "ручки" появился в профессиональной среде аналитиков и разработчиков как неформальное обозначение endpoints. Это связано с тем, что каждый endpoint можно представить как "рычаг" или "кнопку", которую клиент "нажимает", чтобы получить доступ к определенному функционалу сервера.

Пример:
Допустим, в базе данных есть сущность User с полями Id, Name, Email, PasswordHash, RegistrationDate. Клиенту нужно отобразить только Name и Email. Вместо передачи всей сущности создаётся DTO:

public class UserDTO
{
public string Name { get; set; }
public string Email { get; set; }
}

👀 Зачем нужны DTO?

1. Сокрытие внутренней структуры

2. Оптимизация трафика
   Передача только необходимых данных. Например, вместо 20 полей — 3.

3. Адаптация данных
   Объединение данных из разных источников.

🔧 Где применяются DTO?

• REST API: Для структурирования запросов и ответов.

• Микросервисы: Обмен данными между сервисами.

• Клиент-серверные приложения: Передача данных между фронтендом и бэкендом.

🐣 Пример из жизни:

Представьте, что вы в ресторане. Вы (клиент) делаете заказ официанту (API), а он передает его повару (серверу). Вы не видите, как готовится блюдо, но получаете результат. Так и API скрывает сложность внутренней логики, предоставляя простой интерфейс для взаимодействия.

👀 Как работает API?

1. Запрос (Request):
   Одна программа отправляет запрос к API (например: «Дай список пользователей»).

2. Обработка:
   API проверяет запрос, обращается к серверу или базе данных.

3. Ответ (Response):
   API возвращает результат в формате, который понятен запрашивающей стороне (чаще всего JSON или XML).

Пример запроса к веб-API:

GET https://api/users

Пример ответа:

{ "users": [ { "id": 1, "name": "Светлана" }, { "id": 2, "name": "Василий" } ] }

👾 ВидыAPI

• REST — самый популярный тип, использует HTTP-методы (GET, POST, PUT, DELETE).

• SOAP — протокол на основе XML, чаще применяется в корпоративных системах.

• GraphQL — позволяет клиенту запрашивать только нужные данные.

🔧 Инструменты для работы с API

• Postman — тестирование и отправка запросов.

• Swagger (OpenAPI) — автоматическая документация API.