Конфиг
Базовый URL, GET vs POST, заголовки и пагинация.
На этой странице
Базовый URL API:
https://app.strokka.com/api/v1
GET или POST /companies
Оба метода ищут одно и то же. Разница — как передать параметры.
| GET | POST | |
|---|---|---|
| Параметры | query string | JSON-тело |
| Фильтры | filter[city][eq][and]=Москва | filters: [{ field, operator, value, logic }] |
| Когда удобен | короткие запросы | много фильтров, скобки в URL |
В curl квадратные скобки кодируйте через --data-urlencode, иначе bad range in URL. Либо сразу POST.
curl -sS --get "https://app.strokka.com/api/v1/companies" \
--data-urlencode "search=веб-студия" \
--data-urlencode "searchMode=hybrid" \
--data-urlencode "limit=10"Полный набор полей поиска — Поиск. Операторы фильтров — Фильтры.
Заголовки
Content-Type: application/json — на всех POST. Для экспорта ключ кладётся в тело, не в Authorization. См. Аутентификация.
Пагинация
skip ≥ 0 (по умолчанию 0), limit 1–1000 (по умолчанию 100). Объём выборки: limit=1 и смотрите totalCount.