Работа с нашим API очень простая! Наше API позволяет строить целые автономные приложения и сервисы. API - это интерфейс, который позволяет получать информацию из базы данны с помощью https-запросов к специальному серверу. Вам не нужно знать в подробностях, как устроена база, из каких таблиц и полей каких типов она состоит — достаточно того, что API-запрос об этом «знает». Синтаксис запросов и тип возвращаемых ими данных строго определены на стороне самого сервиса.

Системный токен - это как pin от домофона на двери жилого дома. С помощью его Вы получаете вообще доступ к методам API. Его мы Вам выдадим после согласования и подписания договора. Запросить токен можно самим или мы выдадим по собственной инициативе. Внимание, у токена имеются права доступа 3 типов. Права системного токена: юзерский, партнёрский и административный.

1) Юзерский- вы получите доступ к методам для работы с данными пользователей.
2) Партнёрский - вы получите доступ к методам для работы с данными партнёров.
3) Административный - такие права токена выдаются в исключительно редких случаях для управления платформой.

Для чего нужен системный токен? Нужен он для защиты системы от вредоносных действий как DOS, так и от не разрешённого нами импорта данных к примеру тех же самых лент новостей, погоды и т.п..

Пользовательский токен - это как ключт от квартиры в доме. Нужен для того что бы система поняла, от лица какого пользователя идёт действие с системой. При этом системный токен тоже обязателен!

Помините - мы можем отозвать права системного токена или приостановить их на время в любой момент без объяснения причин. Мы также активно ведём LOG журнал использования токена и методов (ip, user-agent и т.п.).
Например, для получения новостей необходимо составить запрос такого вида:
https://api.stavtop.ru/api/news_list.php?system_token=00000&v=1&limit=5
https:// — протокол соединения.
api.stavtop.ru/api/ — адрес API-сервиса.
news_list.php — название метода API ВКонтакте. Методы представляют собой условные команды, которые соответствуют той или иной операции с базой данных — получение информации, запись или удаление. Например, этот метод предоставит ленту из новостей
?system_token=токен&v=1&limit=5 — параметры запроса. После названия метода нужно передать обязательно версию API метода и его входные данные (если они есть) — как обычные GET-параметры в https-запросе. В нашем примере мы сообщаем серверу, что хотим получить список новостей с лимитом 5 новостей.