Здесь можно отправлять живые запросы прямо из браузера: раскройте метод, нажмите Try it out, впишите параметры и Execute. Полная документация с примерами — на странице документации.
Ключ вставляется один раз: нажмите Authorize вверху и введите свой
X-Api-Key — дальше он подставится во все запросы сам. Поле x-api-key
внутри отдельного метода при этом заполнять не нужно.
Ключ нужен для объявлений, телефона и актуализации. Справочники
(/v1/stats, /v1/cities, /v1/facets,
/v1/land-statuses) отвечают и без ключа.
Осторожно с актуализацией: POST /v1/item/{source}/{source_id}/refresh
идёт за свежими данными на сайт-первоисточник. Это медленно (секунды) и ограничено —
не чаще раза в 10 секунд на ключ и раза в 5 минут на одно объявление.