Ortodoksyjne podanie parametrów wywołania REST

Jest sobie hipotetyczny GET na serwis RESTowy, pobiera dane tabelaryczne.

Jak po bożemu zaplanować konwencję podawania parametrów

• lista kolumn, identyfikatory proste lub kwalifikowane z kropką

/persons/withcolumns/ID/imie/nazwisko/rozmrabutów/kierownik.telefon

szczerze mówią nie widzi mi się, jakies lepsze pomysły?

• parametr filtra ogólny tj szukanie w kilku wiodących kolumnach, jakiś string
  /persons/(jakoś kolumny)?query=poszukiwany+poszukiwana
• parametry filtra szczegółowego obwodwpasie=90&rozmiarbutow=43 który się wyklucza z ogólnym

To co zaproponowałeś nie jest i tak restem. Wystaw endpoint w stylu /persons/search?query=...

Ewentualnie nawet parametry w body: https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html

Ja sam korzystam i wszystkim polecam: https://allegro-restapi-guideline.readthedocs.io/en/latest/Representation/#filtering

Może natchnie ciebie bardziej niż Mickiewicz..

@Charles_Ray: > ##### Charles_Ray napisał(a):
To co zaproponowałeś nie jest i tak restem. Wystaw endpoint w stylu /persons/search?query=...

Ewentualnie nawet parametry w body: https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html

Tak czułem, i dokumentacja allegro mnie umocniła, filtr to GET i coś nie nadmiernie skomplikowanego (wszak GET nie ma body), a search, tu masz rację, to POST, i można komplikować.

0xmarcin napisał(a):

Ja sam korzystam i wszystkim polecam: https://allegro-restapi-guideline.readthedocs.io/en/latest/Representation/#filtering

Może natchnie ciebie bardziej niż Mickiewicz..

Przeczytałem od deski do deski. Dobry materiał.