wolfracer/vinaroswrapper

一个简单的用于vinaros公共照明API的包装器

dev-main 2021-02-23 17:05 UTC

This package is auto-updated.

Last update: 2024-09-24 00:30:29 UTC


README

一个简单的用于vinaros公共照明API的包装器

Vinaros API包装器

安装

安装此库需要composer,更多详细信息请访问: https://getcomposer.org.cn/doc/00-intro.md#installation-linux-unix-macos 然后;只需将要求添加到您的composer.json文件中

{
    "require": {
       "wolfracer/vinaroswrapper": "^7.0"
    }
}

安装后,您需要需要安装composer的自动加载器

require 'vendor/autoload.php';

注意SSL证书。

vinaros API使用已弃用的TLS 1.0协议,该协议在Ubuntu 20.04中被默认禁用,这会导致在库中抛出异常。为了避免这种情况,请参阅:https://askubuntu.com/questions/1250787/when-i-try-to-curl-a-website-i-get-ssl-error

快速开始。

use Vinaros\VinarosAlumbradoWrapper;
//instanciar con el url y token del api a acceder, en este caso las de alumbrado publico de vinaros.
$url = 'https://46.24.7.148:8091/lighting/API/v1/';
$token = 'dGVzdDpOZDdHZ29DVWV5V1tFamxTQlduTQ==';
$controller = 'CM0001';
$start_date = '2021-01-30T00:00:00%2B01:00';
$end_date = '2021-02-01T00:00:00%2B01:00';

$wrapper = new VinarosAlumbradoWrapper($url, $token);
//devuelve en formato json el listado de todos los controladores en el api
$json_list = $wrapper->list();
//devuelve el estado de un controlador, pasandole el codigo del mismo
$json_detail = $wrapper->retrieve($controller);
//devuelve todos los valores del controlador pasado entre el intervalo de fechas dado
$json_date_range = $wrapper->retrieve_date_range($controller, $start_date, $end_date);