Поиск

Метод

GET https://login.company.com/blitz/api/v3/users

Поиск учетной записи.

Необходимые разрешения: blitz_api_sys_users.

URL-параметры

В query передается поисковый запрос в формате Resource Query Language (RQL). Операции:

• and – одновременное выполнение поисковых условий;

• or – альтернативное выполнение поисковых условий (например, поиск по разным атрибутам);

• eq – проверка условия равенства.

При выполнении поиска по атрибуту, имеющему строковое значение, рекомендуется явно специфицировать тип значения. Например, string:02142527602.

Внимание

Если поисковый атрибут является строкой, содержащей специальные символы, такие как &|()=<>,, то необходимо придерживаться следующего алгоритма экранирования и кодирования параметров:

1. Выполнить кодирование всех значений атрибутов – экранировать присутствующие в параметрах специальные символы. Например, если выполняется поиск по телефону +7(999)1234567, то значение параметра должно быть преобразовано к значению +7%28999%291234567.

2. Собрать общую строку для передачи в качестве параметра query в запрос. Например, phone_number=+7%28999%291234567.

3. Выполнить URL-Encode значения параметра. Например, получится такое значение параметра – phone_number%3D%2B7%2528999%25291234567.

Примеры

Простой поисковый запрос

Запрос

GET /blitz/api/v3/users?query=eq(phone_number,string:79991234567) HTTP/1.1
Authorization: Bearer eyJraWQiOiJkZWZhdWx0IiwiYWxnIjoiUlMyNTYifQ.eyJzY29wZSI6ImJsaXR6X2FwaV9zeXNfdXNlcnMiLCJqdGkiOiJuWWtKRER2RGhMdVZucl9SYUlOQmdnUldWLTUxbmtJYVdPUGtRRU4tTE93IiwiY2xpZW50X2lkIjoidGF0LWFwaS10ZXN0IiwiZXhwIjoxNzE5NDk5OTY4LCJpYXQiOjE3MTk0ODk5NjgsImF1ZCI6WyJ0YXQtYXBpLXRlc3QiXSwiY3JpZCI6IjAiLCJpc3MiOiJodHRwczovL2JpcC1kZXYxLnJlYXhvZnQucnUvYmxpdHovb2F1dGgifQ.QdQ4tGBeblW46BD2QqwKALWaL1nMR7e6dsAYQYJpuortOz8oy40wfwntWpbHHHDtvyAOGbl4d3pmim9kwnE19bdxQLfy9odCQICBlBjRgfWMJS2xnJ2VtxN_wiHa3SfvcY3HyKJDDD_PLLte3ujCcPZdyfZiNrQe04KR9d6hUDhBIogrqYKcSh6OD_-81aZxidoEI_8uF0n0BPZGAoBZwyEesip1YSULwNhDof7bvp_nLDx8BadEySdHZMEbq7K5kP8jWuKU4oAy6FY2gbQseM27VhiKN5MGi_brPuirnU2Nt_wqu6x-YoHajMHWvSVUzrsTTc-MayqrIWy2wIeSYQ

Ответ

[
   {
      "instanceId":"Mzg5…nU",
      "attrs":{
         "sub":"854436f6-af58-4a3f-8cb7-c2c441eb4a76",
         "family_name":"Иванов",
         "given_name":"Иван",
         "middle_name":"Иванович",
         "phone_number":"79991234567",
      }
   }
]

Сложный поисковый запрос

Запрос

GET /blitz/api/v3/users?query=or(eq(phone_number,string:79991234567),eq(phone_number,string:79991112233)) HTTP/1.1
Authorization: Bearer eyJraWQiOiJkZWZhdWx0IiwiYWxnIjoiUlMyNTYifQ.eyJzY29wZSI6ImJsaXR6X2FwaV9zeXNfdXNlcnMiLCJqdGkiOiJuWWtKRER2RGhMdVZucl9SYUlOQmdnUldWLTUxbmtJYVdPUGtRRU4tTE93IiwiY2xpZW50X2lkIjoidGF0LWFwaS10ZXN0IiwiZXhwIjoxNzE5NDk5OTY4LCJpYXQiOjE3MTk0ODk5NjgsImF1ZCI6WyJ0YXQtYXBpLXRlc3QiXSwiY3JpZCI6IjAiLCJpc3MiOiJodHRwczovL2JpcC1kZXYxLnJlYXhvZnQucnUvYmxpdHovb2F1dGgifQ.QdQ4tGBeblW46BD2QqwKALWaL1nMR7e6dsAYQYJpuortOz8oy40wfwntWpbHHHDtvyAOGbl4d3pmim9kwnE19bdxQLfy9odCQICBlBjRgfWMJS2xnJ2VtxN_wiHa3SfvcY3HyKJDDD_PLLte3ujCcPZdyfZiNrQe04KR9d6hUDhBIogrqYKcSh6OD_-81aZxidoEI_8uF0n0BPZGAoBZwyEesip1YSULwNhDof7bvp_nLDx8BadEySdHZMEbq7K5kP8jWuKU4oAy6FY2gbQseM27VhiKN5MGi_brPuirnU2Nt_wqu6x-YoHajMHWvSVUzrsTTc-MayqrIWy2wIeSYQ

Поиск по строке, содержащей специальные символы

Запрос

GET /blitz/api/v3/users?query=phone_number%3D%2B7%2528999%25291234567 HTTP/1.1
Authorization: Bearer eyJraWQiOiJkZWZhdWx0IiwiYWxnIjoiUlMyNTYifQ.eyJzY29wZSI6ImJsaXR6X2FwaV9zeXNfdXNlcnMiLCJqdGkiOiJuWWtKRER2RGhMdVZucl9SYUlOQmdnUldWLTUxbmtJYVdPUGtRRU4tTE93IiwiY2xpZW50X2lkIjoidGF0LWFwaS10ZXN0IiwiZXhwIjoxNzE5NDk5OTY4LCJpYXQiOjE3MTk0ODk5NjgsImF1ZCI6WyJ0YXQtYXBpLXRlc3QiXSwiY3JpZCI6IjAiLCJpc3MiOiJodHRwczovL2JpcC1kZXYxLnJlYXhvZnQucnUvYmxpdHovb2F1dGgifQ.QdQ4tGBeblW46BD2QqwKALWaL1nMR7e6dsAYQYJpuortOz8oy40wfwntWpbHHHDtvyAOGbl4d3pmim9kwnE19bdxQLfy9odCQICBlBjRgfWMJS2xnJ2VtxN_wiHa3SfvcY3HyKJDDD_PLLte3ujCcPZdyfZiNrQe04KR9d6hUDhBIogrqYKcSh6OD_-81aZxidoEI_8uF0n0BPZGAoBZwyEesip1YSULwNhDof7bvp_nLDx8BadEySdHZMEbq7K5kP8jWuKU4oAy6FY2gbQseM27VhiKN5MGi_brPuirnU2Nt_wqu6x-YoHajMHWvSVUzrsTTc-MayqrIWy2wIeSYQ