УкраїнаДля роботи білінгу необхідно завантажити JSON файл на білінг-сервер Ajax. Файл повинен мати певну назву й бути заповнений відповідно до вимог інструкції. Без цього послуга білінгу не працюватиме.
Як вибрати формат і назву файлу?
Завантажуваний файл має:
Бути у форматі JSON.
Мати назву у форматі часової мітки (дати створення файлу). Формат запису: рррр-мм-дд-гг-хх-сс.json.
Бути записаним у кодуванні UTF-8.
Як заповнити завантажуваний файл?
Структура завантажуваного JSON файлу:
[<br /> {<br /> "hubId": "0000AF49",<br /> "subscriptionFee": "300",<br /> "balance": "300",<br /> "currency": "UAH",<br /> "blocked": "false",<br /> "paymentDate": "2019-12-31"<br /> },<br /> {<br /> ….<br /> }<br />]
Таблиця значень полів:
Назва поля | Опис | Значення |
hubId | Ідентифікатор хаба. Можна побачити в застосунку Ajax у властивостях хаба, а також на корпусі хаба під кріпленням SmartBracket. | 8-символьне HEX-значення Наприклад: 0000AF49 |
subscriptionFee | Сума щомісячного платежу клієнта | Додатні цілі чи дробові числа. Дробові числа записують через крапку з точністю до двох знаків. Наприклад: 1560.50 |
balance | Поточний баланс рахунку клієнта | Додатні, від’ємні, цілі чи дробові числа. Дробові числа записують через крапку з точністю до двох знаків. Наприклад: -1560.50 |
blocked | Запит на блокування/розблокування хаба клієнта | Логічний тип даних: true або false. |
currency | Тип валюти для оплати послуг | Формат запису: UAH |
paymentDate | Дата наступної регулярної оплати послуг клієнтом. | Дата у форматі ISO 8601 (рррр-мм-дд) Наприклад: 2019-12-31 |
Усі поля JSON файлу мають бути заповнені! Інакше послуга білінгу не працюватиме.
Приклад JSON файлу: 2019-12-23-15-43-37
Як завантажити файл на білінг-сервер Ajax?
Завантаження відбувається у два етапи:
Автентифікація користувача на білінг-сервері Ajax
Завантаження файлу на білінг-сервер
Як пройти автентифікацію на білінг-сервері Ajax
Для завантаження JSON файлу необхідно пройти автентифікацію за допомогою приватної частини SSH-ключа, який використовувався під час підключення послуги білінгу.
Зробити це можна через командний рядок або ж за допомогою FTP-клієнтів (наприклад, FileZilla).
Формат команди, що надсилається:
sftp -i ssh_path user_login@sftp.ajax.systems
Розшифрування:
sftp -i — постійна частина, що вказує на підключення до білінг-сервера
ssh_path — шлях до приватної частини SSH-ключа
user_login — логін користувача, який ви отримали під час підключення білінгу
@sftp.ajax.systems — адреса сервера (ендпоін), на яку буде здійснено авторизацію.
Приклад команди, що надсилається: sftp -i C:\ssh_key my_login@sftp.ajax.systems
Як завантажити файл на білінг-сервер Ajax?
Після успішної автентифікації необхідно завантажити JSON файл на білінг-сервер Ajax. Зробити це можна через командний рядок або ж за допомогою FTP-клієнтів (наприклад, FileZilla).
Формат команди, що надсилається:
put json_path
Розшифрування:
put — команда завантаження файлу на білінг-сервер
json_path — шлях до завантажуваного JSON файлу.
Приклад команди, що надсилається: put C:\clients.json
У разі під’єднання через командний рядок після успішного підключення на екрані з’явиться повідомлення: sftp>. Після цього введіть команду: put json_path.