1

NimBus API

Topic: NimBus API

Здравствуйте, дорогие товарищи!

Напомню, что 14 сентября 2017 новый апп от Gurtam — NimBus — увидел мир. Читать в новостях...

Но мы не останавливаемся на достигнутом. Сегодня, 4 октября, наш NimBus также обзавёлся своим собственными API. При помощи него вы можете интегрироваться со сторонними системами, разрабатывать собственные уникальные для рынка решения для пассажирских перевозок и общественного транспорта, импортировать и экспортировать большие объемы данных и мн.др.

Для тех, кто уже пользуется сервисом NimBus, чтобы воспользоваться API:
- войдите в NimBus
- в меню пользователя выберите "Ключи API"
- сгенерируйте ключ/токен или несколько
- используйте во благо и по назначению!
- и не забудьте ознакомиться с API-документацией...

Отзывы по NimBus API можно оставлять в этой теме.

Katerina Alexandrova
Business Analyst
Gurtam
2

NimBus API

(edited by levindv 04/10/2017 17:15:23)

Re: NimBus API

можно ли рассказать подробнее для чего можно использовать єти меню с замками?
для разных настроек авторизации к разным API?
https://preview.ibb.co/d7q7Ab/11.png

3

NimBus API

(edited by spev 05/10/2017 09:41:00)

Re: NimBus API

levindv wrote:

можно ли рассказать подробнее для чего можно использовать єти меню с замками?
для разных настроек авторизации к разным API?

Замок говорит о том, что необходимо ввести ключ чтобы попробовать выполнить запрос внутри этого пункта (Try it out -> Execute).
Выполнив запрос вы сразу в интерфейсе увидите результат его выполнения.

4

NimBus API

Re: NimBus API

Запросы NimBus API можно выполнять из браузера непосредственно со страницы документации. Для этого необходимо указать свой API ключ

Краткая инструкция в картинках

1. В NimBus открываем страницу "Ключи API"

+ show spoiler

https://forum.gurtam.com/misc.php?action=pun_attachment&item=6677&download=0

2. Создаём API ключ

+ show spoiler

https://forum.gurtam.com/misc.php?action=pun_attachment&item=6679&download=0https://forum.gurtam.com/misc.php?action=pun_attachment&item=6680&download=0

3. Копируем API ключ в буфер обмена

+ show spoiler

https://forum.gurtam.com/misc.php?action=pun_attachment&item=6681&download=0

4. Переходим на сайт документации NimBus API и переходим в диалог авторизации (клик по замочку или кнопке Authorize), вставляем ключ из буфера обмена, авторизуемся и закрываем диалог

+ show spoiler

https://forum.gurtam.com/misc.php?action=pun_attachment&item=6682&download=0

5. После указания API ключа выполнять запросы. Для этого открываем любой интересующий запрос и нажимаем "Try it out", а затем "Execute"

+ show spoiler

https://forum.gurtam.com/misc.php?action=pun_attachment&item=6683&download=0

6. Кроме описания запросов и их параметров, документация позволяет изменить параметры запроса, а также просмотреть ответ сервера

+ show spoiler

https://forum.gurtam.com/misc.php?action=pun_attachment&item=6684&download=0

5

NimBus API

Re: NimBus API

Добрый день, коллеги.

Скажите пожалуйста, я правильно понимаю, что на данный в момент с помощью Nimbus API невозможно создавать расписания и рейсы?

Если я не ошибаюсь, Rides  в API - это рейсы, а Timetable - расписание.
Чтобы создать Ride обязательно необходимо передать в качестве параметра
tid*    integer
Timetable id


tid, как я понял - это ссылка на расписание (id расписания).
Расписание - это объект с набором полей, как следует из описания сервиса в .yaml.
А для создания расписания (Timetable) в API нет функции!?

Нам необходимо создавать рейсы с помощью API. Это возможно на данный момент?

6

NimBus API

Re: NimBus API

Добрый день, Antn.

Вы можете создавать расписания путем редактирования необходимого маршрута .

+ пример объекта

{
    ...
    "tt": [
        {
          "id": 0,  // 0 - создаем новый
          "u": null,   // uid объекта на который будет назначаться рейс
          "ptrn": null, // id шаблона
          "t": [   // время посещение соответсвующией остановки с момента начала дня, т.е 39900 - это 11:05
            39900,
           
          ]
        }, ...
  ]

но в таком случае, есть необходимость передавать все расписания, в том числе существующие, иначе они будут удалены.

7

NimBus API

(edited by Antn 13/03/2019 09:04:24)

Re: NimBus API

Добрый день, коллеги.

Благодарю за ответ. Всё получилось.

Следующий вопрос: каким образом реализовать Login с токеном из собственных скриптов, а не со страницы сайта?

В Nimbus нет аналога "token/login", как в Wialon-е?

При запросе "https://nimbus.wialon.com/api/user/token/check"
с передачей в http headers         "accept: application/json","Authorization: Token xxxxxxxxxxxxxxxx"
в ответ получаю "Invalid session".

8

NimBus API

(edited by mitu 13/03/2019 10:57:25)

Re: NimBus API

Добрый день Antn.

Для использования API Nimbus нет необходимости аналога "token/login". Вы должны создать API-Токен (выдав необходимые права для этого ключа) и после создания вы можете использовать этот ключ во всех запросах без каких-либо дополнительных действий.

+ Пример запроса

curl -X GET https://nimbus.wialon.com/api/depots -H "Authorization: Token ..."

9

NimBus API

Re: NimBus API

Всё. Разобрался.

Я использую curl не в режиме командной строки.

$ch = curl_init ();
$options = array (
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => 1,
        CURLOPT_POST => 0,
        curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                'accept: application/json',
                'Authorization: Token xxxxxxxx'
               )
);
curl_setopt_array ( $ch, $options );
   
$result = curl_exec ( $ch );


Без urlencode() и json_encode().

10

NimBus API

Re: NimBus API

Это вопрос срочный идет интеграция с 1с  автотранспортного предприятия города

a.kasimov пишет:
Добрый день!
В нимбусе напротив рейсов есть флажок "автоматическое создание", при включенном положении рейсы создаются автоматически за 5 минут до начала рейса, если данный флаг отключить, то при создании рейса через апи, он создается, но не отображается в списке рейсов. необходима возможность отключения именно автоматического создания рейсов, но чтоб маршруты были активны.