Integrációt segítő könyvtár (PHP)

Telepítés

Legegyszerűbben Composer-rel telepíthető:

composer require utanvet-ellenor/client-php

Használat

Vásárló megbízhatóságának lekérdezése API-n keresztül

Lekérés csak e-mail alapján:

<?php 
  use UtanvetEllenor/Client;

  $client = new Client('publicApiKey', 'privateApiKey');
  $client->email = '[email protected]';
  $client->threshold = 0.8;

  $response = $client->sendRequest();

Lekérés több adat alapján:

<?php 
  use UtanvetEllenor/Client;

  $client = new Client('publicApiKey', 'privateApiKey');
  $client->email = '[email protected]';
  $client->countryCode = 'HU';
  $client->postalCode = '8640';
  $client->phoneNumber = '+36209238883';
  $client->addressLine = 'Szigligeti utca 10.';
  $client->threshold = 0.8;
  $client->orderId = 'order-123456';

  $response = $client->sendRequest();

Az API válasza erre egy JSON string lesz, melyet a client->sendRequest() egy object-ként ad vissza:

{
    "status": 200,
    "result": {
        "good": 3,
        "bad": 5,
        "reputation": -0.25,
        "blocked": true,
        "reason": "Total rate did not meet the minimum threshold set."
    }
}

Rendelés kimenetel (visszajelzés) küldése az API-nak:

A visszajelzések küldésének ideális ideje a rendelés állapotának megváltozása.

<?php
  use UtanvetEllenor/Client;

  $client = new Client('publicApiKey', 'privateApiKey');
  $client->email = '[email protected]';
  $client->outcome = 1;
  $client->orderId = 'order-123456';
  $client->countryCode = 'HU';
  $client->postalCode = '8640';
  $client->phoneNumber = '+36209238883';
  $client->addressLine = 'Szigligeti utca 10.';

  $response = $client->sendSignal();

Teszt környezet

A Client példány sandbox tulajdonságának true-ra állításával a könyvtár a teszt környezetet fogja használni a kérés végrehajtása során.

<?php 
  use UtanvetEllenor/Client;

  $client = new Client('publicApiKey', 'privateApiKey');
  $client->email = '[email protected]';
  $client->threshold = 0.8;
  $client->sandbox = true;

  $response = $client->sendRequest();

A teszt környezet API-ja az élessel megegyezően viselkedik, azonban az általa szolgáltatott adatok véletlenszerűen – semmiképpen se használd éles környezetben!