Правильный код состояния HTTP для использования в запросе помимо известных данных

202 Accepted означает, что сервис успешно принял запрос и с ним пока нет проблем (т. е. проблем с непосредственной проверкой данных нет), но он не может создать ресурс, пока не выполнит дальнейшую обработку. Однако этот ответ не обещает, что ресурс будет создан. Таким образом, он идеально подходит для ожидающих запросов, поскольку ожидающий запрос может быть отклонен во время его обработки.

Также важно добавить заголовок Location с конечной точкой, обслуживающей фактическое состояние асинхронной операции, чтобы клиент мог отслеживать ее периодически.

Не используйте для этого код состояния HTTP 4xx или 5xx.

Их следует использовать только в том случае, если в запросе или ответе есть ошибка, а ее нет.

Ошибки 4xx означают, что запрос не выполнен (чего не произошло), а 5xx означает ошибку сервера.

Обязательно используйте ответ 2xx, либо 200 OK, либо 202 Accepted.

Чтобы объяснить, рассматриваемая конечная точка GET не возвращает ресурс, это просто инструмент для возврата конкретной информации об известных датах.

Это ресурс в смысле REST.

Ключевой абстракцией информации в REST является ресурс. Ресурсом может быть любая информация, которая может быть названа: документ или изображение, временная служба (например, «сегодняшняя погода в Лос-Анджелесе»), набор других ресурсов, невиртуальный объект (например, человек) и т. д. . Другими словами, любое понятие, которое может быть целью авторской гипертекстовой ссылки, должно соответствовать определению ресурса. Ресурс — это концептуальное сопоставление с набором сущностей, а не сущность, которая соответствует сопоставлению в любой конкретный момент времени.

В частности, тот факт, что нечто является ресурсом, никоим образом не зависит от реализации, используемой для обеспечения представления ресурса.

если пользователь делает запрос на дату, которая выходит за пределы (или предшествует) загруженному диапазону дат, как должен реагировать API?

Обычно путем возврата тела сообщения, объясняющего клиенту, в чем заключается проблема, и включения в метаданные кода ответа, указывающего характер ответа на общие компоненты.

В частности, вы хотите обратить внимание на то, как кеши должны взаимодействовать с вашим ответом, учитывая, что они будут просматривать только метаданные, а не полезную нагрузку.

В большинстве случаев, подобных этому, вы хотите сообщить об ошибке и поручить кешу сохранить ответ для последующего использования.

Поэтому вам следует использовать код состояния 404 Not Found.

Код состояния 404 (не найдено) указывает на то, что исходный сервер не нашел текущего представления для целевого ресурса или не желает раскрывать его существование.

404, по сути, является намеком на то, что написание target-uri неверно или что клиент не должен запрашивать этот конкретный ресурс. В любом случае это проблема с запросом, и ее следует обрабатывать таким образом.

Попытка точно такого же запроса в другое время (когда данные для этой даты уже загружены) приведет к успешному ответу.

Обратите внимание, что стандарт HTTP явно указывает на то, что 404 может использоваться в временных условиях:

Код состояния 404 не указывает, является ли это отсутствие представительства временным или постоянным.