Какие знаешь методологии проектирования API

REST (Representational State Transfer) — наиболее популярная методология, основанная на HTTP-методах (GET, POST, PUT, DELETE) и ресурсах. Использует JSON/XML для передачи данных.

Пример REST-эндпоинта:

@app.route('/users/<int:user_id>', methods=['GET'])
def get_user(user_id):
    user = db.get_user(user_id)
    return jsonify(user)

GraphQL — позволяет клиенту запрашивать только нужные данные, избегая over/under-fetching. Использует единую точку входа и схему типов.

Пример запроса:

query {
  user(id: 1) {
    name
    email
  }
}

SOAP — протокол на основе XML с жесткой структурой и WSDL-описанием. Используется в корпоративных системах.

gRPC — высокопроизводительный RPC-фреймворк от Google, использует Protocol Buffers и поддерживает стриминг.

Пример proto-файла:

service UserService {
  rpc GetUser (UserRequest) returns (UserResponse);
}

RPC (JSON-RPC/XML-RPC) — простой протокол вызова удаленных процедур с передачей параметров в JSON/XML.

Выбор зависит от требований к производительности, гибкости и сложности интеграции.