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 быть самодокументируемым.