Ответ сервера 428 Precondition Required

HTTP статус-код 428 (Precondition Required)

HTTP статус-код 428 указывает на то, что сервер требует выполнения определённых условий перед обработкой запроса клиента. Этот код часто встречается в ситуациях, когда необходимо учитывать предшествующие состояния ресурсов, особенно при взаимодействии с API.

Сервер может возвращать статус 428 в различных сценариях, когда клиент не предоставляет необходимые условия для выполнения операции. Рассмотрим подробнее несколько популярных случаев, когда может возникнуть этот статус-код.

Примеры использования статуса 428

• Ситуация с изменением ресурсов

  Когда клиент пытается обновить ресурс, но не указывает условия, при которых обновление должно произойти, сервер может отклонить запрос. Например, если ресурс был изменён другим клиентом, сервер не сможет гарантировать целостность данных.

• Контроль версий

  При попытке удалить или изменить ресурс клиенту необходимо указать, что он работает с актуальной версией ресурса. Это можно сделать с помощью заголовка If-Match. Если заголовок не указан, сервер может вернуть статус 428.

• Кэширование и состояния

  Когда клиент запрашивает данные, которые могут быть изменены, но не указывает, что он хочет работать только с актуальными данными (например, заголовок If-None-Match), сервер может отклонить запрос для предотвращения предоставления устаревшей информации.

Практические примеры исправления ошибки 428

Для предотвращения возникновения статуса 428, клиент должен правильно указывать необходимые условия в запросах. Рассмотрим, как это можно сделать на разных языках программирования.

1. JavaScript (Fetch API)

   
   const url = 'https://api.example.com/resource';
   const headers = new Headers({
       'If-Match': 'etag_value' // Укажите ETag для проверки версии
   });
   
   fetch(url, {
       method: 'PUT',
       headers: headers,
       body: JSON.stringify({ data: 'new data' })
   })
   .then(response => {
       if (response.status === 428) {
           console.error('Необходимы условия для выполнения запроса.');
       }
   });
           

2. Python (requests)

   
   import requests
   
   url = 'https://api.example.com/resource'
   headers = {
       'If-Match': 'etag_value'  # Укажите ETag для проверки версии
   }
   
   response = requests.put(url, headers=headers, json={'data': 'new data'})
   if response.status_code == 428:
       print('Необходимы условия для выполнения запроса.')
           

3. PHP

   
   $url = 'https://api.example.com/resource';
   $options = [
       'http' => [
           'header' => "If-Match: etag_value\r\n", // Укажите ETag для проверки версии
           'method' => 'PUT',
           'content' => json_encode(['data' => 'new data']),
       ],
   ];
   
   $context = stream_context_create($options);
   $result = file_get_contents($url, false, $context);
   if ($http_response_header[0] === 'HTTP/1.1 428 Precondition Required') {
       echo 'Необходимы условия для выполнения запроса.';
   }
           

Сравнительная таблица условий

Условие	Описание	Пример заголовка
If-Match	Указывает, что клиент работает с конкретной версией ресурса.	If-Match: etag_value
If-None-Match	Запрашивает ресурс только в том случае, если он изменился.	If-None-Match: etag_value
If-Modified-Since	Запрашивает ресурс только если он был изменён после указанной даты.	If-Modified-Since: Wed, 21 Oct 2015 07:28:00 GMT

Соблюдение указанных условий поможет избежать возникновения статуса 428 и обеспечит корректную работу с API. Понимание и правильное использование HTTP статус-кода 428 является важным аспектом для разработчиков, работающих с сетевыми запросами.