Vladislav Fursov ghostiam

## tutorial.md

      
              1 file
            
          
              142 forks
            
          
              18 comments
            
          
              1253 stars
            
          
                swalkinshaw
                / tutorial.md
            
            
              Last active
              November 13, 2023 08:40
            
              
                Designing a GraphQL API
              
          
    Moved to Shopify/graphql-design-tutorial


## Проектирование Rest API.txt
Аббревиатура REST расшифровывается как representational state transfer — «передача состояния представления» или, лучше сказать, представление данных в удобном для клиента формате. Термин “REST” был введен Роем Филдингом в 2000 г. Основная идея REST в том, что каждое обращение к сервису переводит клиентское приложение в новое состояние. По сути, REST — не протокол и не стандарт, а подход, архитектурный стиль проектирования API.

Любой ресурс имеет ID, по которому можно получить данные.
Сервер не хранит состояние — это значит, сервер не отделяет один вызов от другого, не сохраняет все сессии в памяти.
Методы POST и PUT должны возвращать обратно объект, который они изменили или создали, — это позволит сократить время обращения к сервису вдвое.

Возвращайте соответствующие http коды статуса в каждом ответе. Успешные ответы должны содержать следующие коды:
200 — для GET запроса и для синхронных DETELE и PATCH
201 — для синхронного POST запроса
202 — для асинхронных POST, DELETE и PATCH запросов
	Аббревиатура REST расшифровывается как representational state transfer — «передача состояния представления» или, лучше сказать, представление данных в удобном для клиента формате. Термин “REST” был введен Роем Филдингом в 2000 г. Основная идея REST в том, что каждое обращение к сервису переводит клиентское приложение в новое состояние. По сути, REST — не протокол и не стандарт, а подход, архитектурный стиль проектирования API.

	Любой ресурс имеет ID, по которому можно получить данные.
	Сервер не хранит состояние — это значит, сервер не отделяет один вызов от другого, не сохраняет все сессии в памяти.
	Методы POST и PUT должны возвращать обратно объект, который они изменили или создали, — это позволит сократить время обращения к сервису вдвое.

	Возвращайте соответствующие http коды статуса в каждом ответе. Успешные ответы должны содержать следующие коды:
	200 — для GET запроса и для синхронных DETELE и PATCH
	201 — для синхронного POST запроса
	202 — для асинхронных POST, DELETE и PATCH запросов