iBus API
Данные общественного транспорта Израиля для вашего сервиса
Остановки, линии, расписания, прибытия в реальном времени и официальные сообщения об изменениях движения - те же данные, что показывает приложение iBus, в JSON по HTTPS. Ключ проект получает после того, как команда iBus рассмотрит заявку.
Что можно получить
Данные, нужные большинству проектов
- Остановкипоиск, остановка, ближайшие, станции поездов
- Прибытия в реальном времениближайшие прибытия на остановку со свежестью
- Расписаниярасписание остановки или линии на день
- Линии и маршрутыпоиск, линия, варианты маршрута, форма
- Сообщения об измененияхофициальные сообщения Минтранса
- Справочные данныеперевозчики, версии, служебный день
- Состояние сервисасостояние и правила свежести
Только по запросу, с объяснением
- Планировщик поездокпоездки от точки отправления до точки назначения - тяжёлое, по запросу
- Выгрузка всей сетивсе остановки сразу - тяжёлое, по запросу
- Положение машинположение без госномеров - по запросу
- Госномера машинтолько по отдельному решению iBus
Тяжёлые или чувствительные данные: iBus решает в каждом случае отдельно. Госномера машин по умолчанию не выдаются.
Как это устроено
- Прочитайте документацию и примеры
- Отправьте заявку о своём проекте
- iBus рассмотрит её и может задать вопросы
- После одобрения создайте ключ для своего сервера
- Сделайте первый запрос с ключом
- Следите за расходом и лимитами в кабинете разработчика
Правила коротко
- Ключ живёт на вашем сервере: не на веб-странице, не в пакете приложения, не в публичном репозитории и не в адресе запроса.
- Передавайте его только как
Authorization: Bearer <ключ>по HTTPS. - Для проверки и для работы - разные ключи. Ключ можно заменить с перекрытием до 24 часов.
- Лимиты принадлежат проекту: все его ключи делят один бюджет на минуту, сутки и месяц.
- Проект можно ограничить адресами вашего сервера (IPv4, IPv6, сети).
- Указывайте источник: «Данные: Министерство транспорта Израиля, через iBus».
Пока - и без ключа. Опубликованные методы пока отвечают и без ключа, с лимитами на сеть, пока существующие интеграции переходят на ключи. Об окончании этого периода объявим на этой странице заранее.
Ваш адрес глазами сервера
Пригодится, прежде чем указывать адреса в заявке. С сервера, который будет обращаться к API: curl https://api.ibusisrael.online/api/access/whoami