Введение в API Топвизор

Документация содержит описание программного интерфейса (API Топвизор), а также информацию о том, как использовать API, включая описание методов и используемых форматов данных. Руководство предназначено для разработчиков и вебмастеров, которым необходим доступ к данным и возможностям сервиса Топвизор.

Предполагается, что читатель владеет терминологией и понимает принципы работы сервиса. Руководство пользователя, часто задаваемые вопросы и ответы на них находятся в Справочном центре.

Адрес сервера и авторизация

Все действия в API Топвизор выполняется от имени зарегистрированного в сервисе пользователя. Клиентское приложение должно быть авторизовано посредством API ключа.

Чтобы получить ответ на запрос, необходимо обратиться к серверу API по адресу:

https://api.topvisor.com/

Постраничный доступ к данным

Для получения большого объема данных рекомендуется использовать постраничный вывод результатов.
Для этого в запросе на получение данных необходимо указать аргумент:

getFormat=json_pager.

Аргумент	Описание	Возможные значения
getFormat	Формат данных	Всегда json_pager
limit	Количество возвращаемых объектов на одну страницу	От 1 до ∞. Разные методы могут иметь различные ограничения по максимальному значению.
* page	Номер страницы	От 1 до ∞
* offset	Количество пропускаемых объектов	От 0 до ∞

* можно использовать либо page либо offset, в зависимости от реализуемой задачи.
Не рекомендуется одновременное использование этих параметров.

Ответы сервера для постраничных запросов

I - при использовании использование page

{ page: 1, // номер полученной страницы total: 5, // всего страниц limit: 10, // количество результатов на 1 страницу records: 55, // всего найденных результатов rows: [] // массив результатов }

II - при использовании offset

{ limit: 10, // количество результатов, возвращаемых 1 запросом offset: 0, // пропущенно результатов records: 55, // всего найденных результатов rows: [] // массив результатов }