подпишитесь на запрос в webapi

Question

Мое понимание REST заключается в том, что все, что не изменяет состояние базовой системы (например, запрос), должно быть GET-запросом. Это также означает, что параметры запроса должны быть помещены в URI, как так:

api/SomeMethod/Parameter1/{P1:double}/Parameter2/{P1:double} 

или как строки запроса, как описано здесь:

REST API Best practice: How to accept list of parameter values as input

Иногда запрос может потребоваться длительный вектор (номер точек х/у). Как мне решить проблему длины URI здесь? Должен ли я просто использовать POST? Благодарю.

Answer 1

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

Например, создать коллекцию на:

api/Vector 

Тогда ваши клиенты API могут POST свои большие векторы, а затем в другом запросе обращаться к нему по одному номеру идентификатора.

Это значительно уменьшает размер длины запроса, сохраняется REST и позволяет легко переносить эти векторы. Если вы беспокоитесь о хранении, срок действия вектора истекает через 30 минут или дольше.

Другой вариант - спуститься по дороге JSON-LD, которая аналогична, за исключением того, что вы не переносите векторы. Вы просто предоставляете объект @context, а клиенты API будут размещать вектор на своем собственном сервере и ссылаться на его API по URL-адресу в параметре запроса.