Descrizione
Questo metodo può essere utilizzato per ottenere la lista delle zone geografiche attualmente presenti all'interno del sistema.
Utilizzo
Non ci sono parametri specifici richiesti per l'utilizzo di questo metodo. In caso di successo ritorna un'array di oggetti così strutturati:
- geoZoneId: Id della zona geografica.
- geoZoneName: Nome della zona geografica.
- geoZoneDescription: Descrizione della zona geografica.
- countriesList: Array di oggetti che rappresentano le nazioni associate alla zona geografica così composti:
- countryCode: Codice ISO che rappresenta la nazione.
- countryName: Nome della nazione.
- countiesList: Array di oggetti che rappresentano le provincie / stati associate alla zona geografica così composti:
- countyZone: Codice della provincia / stato.
- countyName: Nome della provincia / stato.
Gestione errori
In caso di errore il metodo genererà un'eccezione che riporterà uno dei seguenti codici di errore:
- ERROR_INVALID_TOKEN: Non è stato effettuato nessun login in precedenza o la sessione è scaduta per inutilizzo.
- ERROR_INVALID_IP: L'indirizzo ip del server che sta effettuando la chiamata non valido perchè non inserito nella whitelist associata alle credenziali.
- ERROR_SERVER_UNAVAILABLE: Il server non è disponibile o si è verificato un errore di comunicazione generico.
PHP
require "vendor/autoload.php" try { $ezPrintSDK = new ezPrintSDKWrapper('http://demo.ezprint.it'); $apiToken = $ezPrintSDK->cLoginAPI('1WHm0icsupAEm9fil9en','yCHZ0nKiyn1MU0DhpgmG'); $geographicalZones = $ezPrintSDK->backOffice->bGetGeographicalZones(); foreach($geographicalZones as $zone) { echo $zone['geoZoneId'], ' ', $zone['geoZoneName']; } } catch (Exception $e) { echo 'Error Code: ', $e->getMessage(); }
Node.js
try { var ezPrintSDK = require('ezprint-sdk-wrapper'); ezPrintSDK.initializeWrapper('http://demo.ezprint.it'); var apiToken = ezPrintSDK.cLoginAPI('1WHm0icsupAEm9fil9en','yCHZ0nKiyn1MU0DhpgmG'); var geographicalZones = ezPrintSDK.backOffice.bGetGeographicalZones(); geographicalZones.forEach(function(zone) { console.log(zone.geoZoneId); console.log(zone.geoZoneName); }); } catch (ex) { console.log(ex); }
.NET (C#)
try { ezPrintSDKWrapper.Client ezPrintSDK = new ezPrintSDKWrapper.Client("http://demo.ezprint.it"); ezPrintSDK.cLoginAPI("1WHm0icsupAEm9fil9en","yCHZ0nKiyn1MU0DhpgmG"); List<ezPrintSDKWrapper.Structures.geographicalZoneItem> geographicalZones = ezPrintSDK.BackOffice.bGetGeographicalZones(); foreach (ezPrintSDKWrapper.Structures.geographicalZoneItem zone in geographicalZones) { System.Console.WriteLine("Zone {0}: {1}", zone.geoZoneId, zone.geoZoneName); } } catch (ezPrintException ex) { string ErrorMessage = ex.Message; }