API Rest с (слишком) большим количеством ссылок и / или требованиями множественного выбора - PullRequest
1 голос
/ 02 апреля 2019

Мы разрабатываем API для поддержки настройки и запуска отчета, основанного на множестве параметров, некоторые из которых имеют много (тысячи) множественных значений.Я ищу способ предложить эти варианты в чем-то отличном от отдельных ссылок.

Во-первых, мы хотим провести их через параметры (которые я считаю вспомогательными) упорядоченным способом.b / c зависимостей

POST v1/reports/GUID/parm1 w/ JSON payload {parm1: value1}
POST v1/reports/GUID/parm2 etc

В какой-то момент у parmX будет много опций.Предположим, что parmX-1 был отправлен, мы хотим представить им некоторый список (многих) множественных значений для parmX, и они будут делать что-то вроде:

POST v1/report/GUID/parmX w/ JSON payload {parmsX: [valueA, valueB, ..., valueC]}

Я не вижу в любом случаеделать это иначе, чем представлять параметры в ответе (для запроса parmX-1) как некоторый объект JSON и, возможно, некоторые свойства, которые связывают его с реальными обслуживаемыми ссылками.

Это только одна из техвещи, которые подпадают под «иногда вам приходится ломать HATEOAS и документировать это в своем API»?

...