Программный интерфейс приложения
Application Programming Interface
Пример API из реальной жизни
Когда необходимо сориентироваться на местности, мы пользуемся приложением «Карты» (Google Maps, Yandex Maps).
«Карты» предоставляют географическую информацию не только пользователям, но и другим приложениям при помощи API.
Приложение «Навигатор» выступит в роли клиента, а приложение «Карты» — сервера.
- «Навигатор» передает запрос по протоколу HTTPS с параметрами начальной и конечной точки маршрута в формате JSON
- Получает ответ в формате JSON от приложения «Карты»
- Отображает маршрут, ближайшие заправки, предупреждает о загруженности дорог
Выступите в роли клиента. Передайте серверу координаты для сохранения стартовой точки.
Заполните форму «Форма для отправки HTTP-запроса» и отправьте HTTP-запрос на сервер.
Договорённость по формату запроса:
- URL адрес запрашиваемого ресурса: /startpoint (в данном случае используем только окончание адреса, т.н. эндпоинт)
- HTTP метод, соответствующий отправке новых данных на сервер (см. HTTP методы)
- Заголовок с типом контента application/json (указывает на то, что данные будут переданы в JSON формате)
- Тело запроса должно содержать параметры latitude и longitude в JSON формате
| Ключ | Описание | Тип | Обязательность * | Ограничения |
|---|---|---|---|---|
| latitude | широта | число | + | от -90.0 до 90.0 |
| longitude | долгота | число | + | от -180.0 до 180.0 |
* Обязательность говорит об обязательности указания поля, может принимать значения:
- При обязательности +, Y, Yes, Да, 1
- При необязательности -, N, No, Нет, 0..1
Уровень повышен!
Временное предложение
Премиум аккаунт со скидкой 30%!
