Cards

Методы работы с картами

Для работы с картами используется 2 режима работы (переменная mode): 1. Get - для чтения карт.

2. Set - для записи карт.

Get card list

GET http://YOUR_SITE.petroline.net.ua/index.php?r=terminals/API&type=cards&mode=get

Получение списка карт и их параметров.

Path Parameters

Name	Type	Description
mode=get	string	"get" для получения списка карт.
hashkey	string	хэш-ключ для авторизации запроса - пароль администратора.
type=cards	string	Тип запроса. Для получения карт параметр должен быть равен "cards".

200

{
    count: 3,
    cards: [
        {
            number: "0030007035BB",
            state: "0",
            owner: "GooD",
            description: "Заправщик",
            expire: "2019-01-01",
            card_type: "3"
        },
        {
            number: "003000704CDD",
            state: "0",
            owner: "Бор",
            description: "ГАЗ",
            expire: "2020-03-31",
            card_type: "3"
        },
        {
            number: "003000705745",
            state: "0",
            owner: "Остап",
            description: "КАМАЗ",
            expire: "2020-03-24",
            card_type: "3"
        }
    ],
    status: 200,
    message: "OK"
}

Возвращаемые параметры

• count - общее количество результирующих объектов (операций заправок).

• message - результирующий ответ, индикатором верного ответа является "ОК", иначе - ошибка.

• number - RFID номер карты.

• state - состояние карты (0 - заблокирована, 1 - активна).

• owner - имя/название водителя (иногда транспортного средства) по карте.

• description - описание, дополнительно поле карты.

• expire - срок действия карты (дата).

• card_type - тип карты (0 - расчетная, 3 - лимитная, 4 - техпролив, 5 - перемещение).

Edit card info by number

GET http://YOUR_SITE.petroline.net.ua/index.php?r=terminals/API&type=cards&mode=set

Редактирование параметров карты на основании номера карты.

Path Parameters

Name	Type	Description
number	string	Полный RFID номер карты. Указан в методе Get card list под параметров number.
type=cards	string	Тип запроса. Для получения карт параметр должен быть равен "cards".
mode=set	string	"set" для записи карты
hashkey	string	хэш-ключ для авторизации запроса - пароль администратора.

Query Parameters

Name	Type	Description
expire	string	Записываем указанное значение даты карты. Формат даты yyyy-mm-dd (2019-01-23).
description	string	Записываем указанное описание карты.
owner	string	Записываем указанное название карты.
state	boolean	0 - отключена; 1 - активна;

200 Если изменение произошло, получим в ответ - ОК.

{
    status: 200,
    message: "OK"
}

400 Если нечего менять:

{
    status: 400,
    message: "Save error, nothing to change"
}