ajtarragona/accede-client

Accede (Aytos) 第三方和线路访问客户端

v2.0.1 2020-10-30 09:48 UTC

This package is auto-updated.

Last update: 2024-09-05 20:11:23 UTC


README

Accede (Aytos) WS 访问包,用于第三方和线路

安装

composer require ajtarragona/accede-client:"@dev"

配置

您可以通过应用程序的 .env 文件配置此包。以下为可用的参数

ACCEDE_TOKEN_KEY 
ACCEDE_WS_URL 
ACCEDE_USER 
ACCEDE_PASSWORD 
ACCEDE_CLIENT 
ACCEDE_ENTITY 
ACCEDE_ORGANISM 

或者,您可以使用以下命令发布配置文件

php artisan vendor:publish --tag=ajtarragona-accede-config

这会将文件复制到 config/accede.php

发布 Laroute 配置

php artisan vendor:publish --provider='Lord\Laroute\LarouteServiceProvider'

app/config/laroute.php 中放置绝对路由

每次更改路由时,发布 laroute 脚本

php artisan laroute:generate

使用方法

配置完成后,该包即可使用。

您可以使用以下方式之一

通过 Facade

use AccedeTercers;
use AccedeVialer;
use Firmadoc;
...
public function test(){
	$tercer=AccedeTercers::getTercerById(123456);
	$vies=AccedeVialer::getAllVies();
	$tipusdoc=Firmadoc::getTipusDocument(1234);
	...
}

在这种情况下,为了便于使用,可以在 config/app.php 文件中注册 Facade 的别名

'aliases' => [
	...
	'AccedeTercers' => Ajtarragona\Accede\Facades\AccedeTercers::class,
	'AccedeVialer' => Ajtarragona\Accede\Facades\AccedeVialer::class,
	'Firmadoc' => Ajtarragona\Accede\Facades\Firmadoc::class
]

依赖注入方式

在你的控制器、辅助工具、模型中

use Ajtarragona\Accede\Models\AccedeTercersProvider;
use Ajtarragona\Accede\Models\AccedeVialerProvider;
use Ajtarragona\Accede\Models\FirmadocProvider;
...
public function test(AccedeTercersProvider $accedetercers, AccedeVialerProvider $accedevialer){
	$tercer=$accedetercers->getTercerById(123456);
	$vies=$accedevialer->getAllVies();
	$tipusdoc=Firmadoc::getTipusDocument(1234);
	...
}

通过 helper 函数

...
public function test(){
	$tercer=accedetercers()->getTercerById(123456);
	$vies=accedevialer()->getAllVies();
	$tipusdoc=firmadoc()->getTipusDocument(1234);
	...
}

函数

AccedeTercers

在所有情况下,如果失败或未找到,则返回异常。

AccedeVialer

在所有情况下,如果失败,则返回 AccedeErrorException 异常;如果未找到,则返回 AccedeNoResultsException 异常。

Firmadoc

JSON API

//Paisos

/ajtarragona/accede/api/paisos
/ajtarragona/accede/api/paisos/{codigoPais}

//Provincies
/ajtarragona/accede/api/provincies
/ajtarragona/accede/api/provincies/{codigoProvincia}

//Municipis
/ajtarragona/accede/api/provincies/{codigoProvincia}/municipis
/ajtarragona/accede/api/provincies/{codigoProvincia}/municipis/{codigoMunicipio}


//Vies
/ajtarragona/accede/api/provincies/{codigoProvincia}/municipis/{codigoMunicipio}/vies/search/{filter}
/ajtarragona/accede/api/provincies/{codigoProvincia}/municipis/{codigoMunicipio}/vies/combo
/ajtarragona/accede/api/provincies/{codigoProvincia}/municipis/{codigoMunicipio}/vies
/ajtarragona/accede/api/provincies/{codigoProvincia}/municipis/{codigoMunicipio}/vies/{codigoIneVia}


//Numeros de la via
/ajtarragona/accede/api/numeros/combo/{codigoIneVia}
/ajtarragona/accede/api/numeros/{codigoIneVia}

//Blocs de la via
/ajtarragona/accede/api/blocs/combo/{codigoIneVia}
/ajtarragona/accede/api/blocs/{codigoIneVia}

//Escales de la via
/ajtarragona/accede/api/escales/combo/{codigoIneVia}/{numero?}
/ajtarragona/accede/api/escales/{codigoIneVia}/{numero?}

//Lletres de la via
/ajtarragona/accede/api/lletres/combo/{codigoIneVia}/{numero?}
/ajtarragona/accede/api/lletres/{codigoIneVia}/{numero?}

//Plantes de la via
/ajtarragona/accede/api/plantes/combo/{codigoIneVia}/{numero?}
/ajtarragona/accede/api/plantes/{codigoIneVia}/{numero?}

//Codis postals de la via
/ajtarragona/accede/api/codispostals/combo/{codigoIneVia}/{numero?}
/ajtarragona/accede/api/codispostals/{codigoIneVia}/{numero?}

//Portes de la via
/ajtarragona/accede/api/portes/combo/{codigoIneVia}/{numero?}/{nombrePlanta?}
/ajtarragona/accede/api/portes/{codigoIneVia}/{numero?}/{nombrePlanta?}

Web 组件

php artisan vendor:publish --tag=ajtarragona-accede-assets --force