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".

{
    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 - активна;

{
    status: 200,
    message: "OK"
}

Last updated