webservices-nl/platform-connector

platform connector generator for Webservices.nl

Webservices Platform Connector

External checks

, _(*1)

This factory abstracts protocol specific's implementations for connecting to the Webservices.nl API. Providing an unified service layer independent of protocol., _(*2)

The purpose of this library is to connect to any of the Webservices.nl API's (platforms) in a uniform way. Regardless of transport protocol it ships a proxy class for type hinted function calls to Webservices.nl function calls., _(*3)

Supported protocols

Webservices.nl support multiple protocols for connecting. Soap, XML-RPC, HTTP-RPC/REST. This library has support for multiple transfer protocols., _(*4)

Soap

This library ships a SoapClient that extends the native PHP SoapClient with a curl client for better timeout management. Also converts native PHP SoapFault into custom platform exceptions where possible., _(*5)

XML-RPC

Scheduled to be released., _(*6)

REST

Scheduled to be released., _(*7)

Pre-requisites

• PHP 5.6<=
• composer
• PSR-log LoggerInterface (optional)

Install

Please use composer to install this library. Or download the latest zip, _(*8)

composer require webservices-nl/platform-connector, _(*9)

Usage

 // Instantiate a ConnectorFactory with your given Webservices.nl credentials.
 $factory = ConnectorFactory::build(
  [
    'username' => 'myusername',
    'password' => 'secret'
  ],
  LoggerInterface (optional)
 );

 // build a client
 $client = $factory->create('soap', 'webservices');

 // make type hinted function calls to any of the Webservices.nl API's
 $response = $client->accountEditV2();

All parameters are expected to be in UTF-8 encoding, output is in UTF-8 as well., _(*10)

Unit test

This client is fully tested on PHP 5.6+ and 7+ To run tests:, _(*11)

./vendor/bin phpunit, _(*12)

Further information

Consult the online documentation. Any questions, remarks, bugs? Please mail us. - technical questions: tech@webservices.nl - support questions: mailto:support.webservices.nl, _(*13)