Примеры

Hybrid-поиск с фильтрами и колонками

Типичная задача: текстовый поиск + фильтры (регион, WhatsApp, email…) и нужны конкретные поля в карточках — не стандартный набор name, domain, city.

Без параметра columns API подбирает колонки автоматически (columnProjection: inferred). Фильтр по whatsapp отберёт компании, но не добавит whatsapp в ответ. Решение — явный columns.

Сценарий: логистика в Подмосковье с WhatsApp

Задача: найти компании по запросу «логистика», отфильтровать по региону и наличию WhatsApp, в ответе получить название, описание, ключевые слова, email, phone и whatsapp.

Сравнение: с columns и без

Без columns — фильтр работает, но в карточках может не быть whatsapp:

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "логистика",
    "searchMode": "hybrid",
    "limit": 3,
    "filters": [
      {"field": "whatsapp", "operator": "not_empty", "value": "true", "logic": "and"}
    ]
  }'

В ответе: columnProjection: "inferred", displayFields обычно без whatsapp.

С columns — строгая проекция, только то, что запросили:

Code
curl -sS -X POST "https://app.strokka.com/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "логистика",
    "searchMode": "hybrid",
    "limit": 3,
    "columns": ["name", "whatsapp"],
    "filters": [
      {"field": "whatsapp", "operator": "not_empty", "value": "true", "logic": "and"}
    ]
  }'

Ошибки

Ситуация	HTTP	Что делать
Неизвестное поле в columns, например "foo"	422	Исправьте имя; список допустимых полей — в тексте ошибки
Опечатка в фильтре	422	См. Фильтры
Слишком частые запросы	429	Пауза; см. Лимиты

Пример 422:

Code
{
  "detail": "Unknown columns: ['foo']. Allowed fields include: address, city, description, email, …"
}

Что дальше?

• Поиск — все режимы и параметр columns
• Фильтрация выборки — больше сценариев с фильтрами
• Поиск и экспорт — полные контакты без маски