Справочники

Канонические значения для фильтров sector, tech, region, city и location.

Эндпоинты /dictionaries/* отдают допустимые значения для фильтров. Поиск компаний по-прежнему идёт через /companies. Авторизация не нужна.

Эндпоинты

Базовый URL: https://app.strokka.com/api/v1

Поле filterValue

Для tech оператор contains — точное вхождение в массив, не подстрока.

Отрасли

curl -sS "https://app.strokka.com/api/v1/dictionaries/sectors"

{
  "total": 27,
  "items": [
    {
      "id": 5,
      "name": "Информационные технологии",
      "filterValue": "Информационные технологии"
    }
  ]
}

Технологии

curl -sS "https://app.strokka.com/api/v1/dictionaries/technologies"

curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "searchMode=sql" \
  --data-urlencode "filter[tech][eq][and]=WordPress" \
  --data-urlencode "columns=name,domain,tech_stack" \
  --data-urlencode "limit=20"

Фрагмент tech_stack:

[
  { "category": "cms_and_site_builders", "technologies": ["Tilda"] },
  { "category": "analytics", "technologies": ["Yandex Metrica"] }
]

Гео

Данные FIAS/GAR. В карточках компаний регион и город приведены к формату справочника (Саратовская область, г. Саратов), не к сокращениям вроде обл. Саратовская.

Регионы

filterValue = displayName. Список: GET /dictionaries/regions. Один субъект: GET /dictionaries/regions/64.

Населённые пункты

Обязателен region_code или q (минимум 2 символа). Без q возвращаются только города (GAR level 5).

curl -sS --get "https://app.strokka.com/api/v1/dictionaries/localities" \
  --data-urlencode "region_code=64" \
  --data-urlencode "q=балак" \
  --data-urlencode "limit=20"

Типичный сценарий UI

1. 1

   Загрузите справочники

   GET /dictionaries/sectors, /technologies, /regions.

2. 2

   Подставьте filterValue

   Отрасль → filter[sector], технология → filter[tech], регион → filter[region].

3. 3

   Город

   GET /dictionaries/localities?region_code=64&q=… → filter[city].

4. 4

   Поиск

   Примените фильтры к GET или POST /companies.

Ошибки