REST API

REST APIs используют HTTP methods для управления ресурсами, идентифицированными URI, обеспечивая масштабируемые, гибкие web services.

REST APIs моделируют приложения как коллекцию ресурсов, идентифицированных уникальными URI. Клиенты взаимодействуют с этими ресурсами, используя фиксированный набор операций, обычно сопоставленных с HTTP methods (GET, POST, PUT, PATCH, DELETE). Ключевые ограничения включают: statelessness (отсутствие серверного контекста клиента между запросами), uniform interface (стандартизированные методы, URI и media types), client–server separation, cacheability и layered system. Representations (обычно JSON или XML) передаются через HTTP, а content negotiation, versioning и HATEOAS (опционально) управляют взаимодействием клиента. REST является architectural style, а не протоколом, и хотя он хорошо согласуется с web, практичный RESTful дизайн требует балансировки между over-fetching, under-fetching и concerns безопасности, такими как authentication, authorization и transport security (TLS).

        graph LR
  Center["REST API"]:::main
  Pre_http["http"]:::pre --> Center
  click Pre_http "/terms/http"
  Pre_api["api"]:::pre --> Center
  click Pre_api "/terms/api"
  Rel_apache_http_server["apache-http-server"]:::related -.-> Center
  click Rel_apache_http_server "/terms/apache-http-server"
  classDef main fill:#7c3aed,stroke:#8b5cf6,stroke-width:2px,color:white,font-weight:bold,rx:5,ry:5;
  classDef pre fill:#0f172a,stroke:#3b82f6,color:#94a3b8,rx:5,ry:5;
  classDef child fill:#0f172a,stroke:#10b981,color:#94a3b8,rx:5,ry:5;
  classDef related fill:#0f172a,stroke:#8b5cf6,stroke-dasharray: 5 5,color:#94a3b8,rx:5,ry:5;
  linkStyle default stroke:#4b5563,stroke-width:2px;

      

🧒 Простыми словами

Это как торговый автомат. Вы выбираете товар по коду и получаете его. Автомат не запоминает вас после покупки.

🤓 Expert Deep Dive

Ключевые ограничения: Клиент-Сервер, Stateless, Cacheable, Layered System. Часто используется JSON. HATEOAS позволяет API быть самодокументируемым.

🔗 Связанные термины

Предварительные знания:

📚 Источники