Каков наилучший способ передать несколько параметров запроса в restful api?

Я разрабатываю RESTful Api и хотел бы получить совет по разработке API, где вызывающий абонент хочет запросить записи на основе нескольких параметров поиска.

Я только видел restis-apis, которые используют один параметр.

как мне это сделать?

например. если я создал спокойный api для списка контактов, как бы я форматировал вызов, который возвращал все контакты с firstname == bob и фамилия == smith?

Я предполагаю, что это должно быть GET, потому что я извлекаю?

Мои мысли:

http://api.myapi.com/contacts/firstname/bob&surname=smith

Но это не кажется правильным; - (

Пожалуйста, совет.

Кроме того, поддерживает ли какая-либо инфраструктура php это? например symfony, konstrukt и т.д.

Ответ 1

Я думаю,

http://api.myapi.com/contacts?firstname=bob&surname=smith

- путь, если у вас есть набор параметров, все из которых являются необязательными.