Консоль API
Те же пятнадцать методов, но их можно вызвать прямо отсюда. Подставьте ключ, заполните параметры и посмотрите настоящий ответ сервера — до того, как писать первую строчку кода.
Четыре действия
Интерфейс консоли англоязычный: так его отдаёт библиотека. Названия кнопок ниже приведены как есть, чтобы их было видно на экране.
- 1Нажмите Authorize
Зелёная кнопка над списком методов. Вставьте ключ в поле Value и нажмите Authorize, затем Close. Слово Bearer добавлять не нужно, только сам ключ.
заголовок Authorization - 2Раскройте метод и нажмите Try it out
До этого поля параметров показаны, но недоступны: это защита от случайного вызова.
- 3Заполните параметры и нажмите Execute
Обязательные помечены красной звёздочкой. Для первого запроса возьмите car/info и подставьте любой VIN в поле q.
- 4Смотрите ответ
Ниже появятся код, тело ответа, заголовки и готовая команда curl — её можно скопировать себе и запустить в терминале.
Два метода отвечают и без ключа: /ip/ показывает, каким сервер видит ваш адрес, а /example/prices — образец ответа с ценами. С них удобно проверить, что консоль вообще работает.
Ключ никуда к нам не попадает. Страница статическая, запросы уходят из вашего браузера прямо в api.goodvin.net/v1, а сам ключ живёт в памяти вкладки: обновили страницу — вводите заново. Мы его намеренно не запоминаем, чтобы он не остался на чужом компьютере.
Каждый вызов car/info с новым VIN — это списанный запрос, здесь так же, как из кода. Для проб берите ключ песочницы. Повторный вызов с тем же номером в течение суток отдаётся из кеша и пакет не расходует, так что нажимать Execute второй раз не страшно.
Методы
Список собирается из машинной спецификации самого сервера, поэтому расходиться с боевым API он не может.
Загружается консоль…