first commit

2 files changed, 149 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..62d4feb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+##About##
+GsxLib is a PHP library that simplifies communication with Apple's GSX web service API. It frees the application developer
+from knowing the underlying PHP SOAP architecture and to some extent even the GSX API itself. GsxLib also tries to provide
+some performance benefits by minimizing the number of requests made to the servers as well as doing some rudimentary input
+validation (as opposed to burdening Apple's servers with totally invalid requests).
+
+##Requrements##
+Your PHP should have SOAP support enabled. Most distributions should (including OS X Server 10.6 or later).
+For more details, consult your distribution or http://php.net/manual/en/book.soap.php.
+
+##Usage##
+
+  <?php
+  
+    include 'gsxlib/gsxlib.php';
+    $gsx = new GsxLib('your sold-to account', 'gsx user', 'password');
+    $info = $gsx->warrantyStatus('serialnumber');
+  
+  ?>
+
+
+##License##
+
+  DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE 
+    Version 2, December 2004
+    Copyright (C) 2004 Sam Hocevar <sam@hocevar.net> 
+    Everyone is permitted to copy and distribute verbatim or modified 
+    copies of this license document, and changing it is allowed as long 
+    as the name is changed. 
+    
+    DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE 
+    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 
+    0. You just DO WHAT THE FUCK YOU WANT TO.
diff --git a/gsxlib.php b/gsxlib.php
new file mode 100644
index 0000000..6f61703
--- /dev/null
+++ b/gsxlib.php
@@ -0,0 +1,116 @@
+<?php
+/**
+ * gsxlib/gsxlib.php
+ * @author Filipp Lepalaan <filipp@mcare.fi>
+ * This program is free software. It comes without any warranty, to
+ * the extent permitted by applicable law. You can redistribute it
+ * and/or modify it under the terms of the Do What The Fuck You Want
+ * To Public License, Version 2, as published by Sam Hocevar. See
+ * http://sam.zoy.org/wtfpl/COPYING for more details.
+ */
+class GsxLib
+{
+  private $client;
+  private $region;
+  private $session_id;
+  private $environment;
+  
+  
+  function __construct($account, $username, $password, $environment = 'ws', $region = 'emea', $tz = 'CEST')
+  {
+    if (!class_exists('SoapClient')) {
+      exit('Looks like your PHP lacks SOAP support');
+    }
+    
+    if (!preg_match('/\d+/', $account)) {
+      exit('Invalid Sold-To: ' . $account);
+    }
+    
+    $regions = array('am', 'emea', 'apac', 'la');
+    
+    if (!in_array($region, $regions)) {
+      exit('Region must be one of: ' . implode(', ', $regions));
+    }
+    
+    $envirs = array('ws', 'ut', 'it');
+    
+    if (!in_array($environment, $envirs)) {
+      exit('Environment must be one of: ' . implode(', ', $envir));
+    }
+    
+    $wsdl = 'https://gsx'.$environment.'.apple.com/gsx-ws/services/'.$region.'/asp?wsdl';
+    $this->client = new SoapClient($wsdl, array('exceptions' => TRUE, 'trace' => 1));
+    
+    if (session_id()) {
+      $_SESSION['_gsxlib_client'] = serialize($this->client);
+    }
+    
+    if (!$this->client) {
+      exit('Failed to create SOAP client.');
+    }
+    
+    $a = array(
+      'AuthenticateRequest' => array(
+        'userId'            => $username,
+        'password'          => $password,
+        'serviceAccountNo'  => $account,
+        'languageCode'      => 'en',
+        'userTimeZone'      => $tz)
+    );
+    
+    if (@$_SESSION['_gsxlib_session_timeout'] > time()) {
+      return $this->session_id = $_SESSION['_gsxlib_session_id'];
+    }
+    
+    try {
+      $this->session_id = $this->client->Authenticate($a)->AuthenticateResponse->userSessionId;
+    } catch (Exception $e) {
+      exit('Authentication with GSX failed');
+    }
+    
+    // there's a session going, put the credentials in the
+    if (session_id()) {
+      $_SESSION['_gsxlib_session_id'] = $this->session_id;
+      $_SESSION['_gsxlib_session_timeout'] = time()+60*30;
+    }
+    
+  }
+  
+  public function partDetails($partNumber)
+  {
+    if (!preg_match('/^\w+\-\w+^/', $partNumber)) {
+      exit('Invalid part number: ' . $partNumber);
+    }
+    
+  }
+  
+  /**
+   * A shortcut for checking warranty status of device
+   */
+  public function warrantyStatus($serialNumber)
+  {
+    if (!preg_match('/^[a-z0-9]{7,18}$/i', $serialNumber)) {
+      exit('Invalid serial number: ' . $serialNumber);
+    }
+    
+    $a = array(
+      'WarrantyStatusRequest' => array(
+        'userSession' => array('userSessionId' => $this->session_id),
+        'unitDetail'  => array('serialNumber' => $serialNumber)
+    ));
+    
+    $result = $this->client->WarrantyStatus($a);
+    return $result->WarrantyStatusResponse->warrantyDetailInfo;
+  
+  }
+  
+  public function request($args)
+  {
+    $info = $client->WarrantyStatus($a);
+    $out[] = $info->WarrantyStatusResponse->warrantyDetailInfo;
+  }
+  
+}
+
+
+?>
\ No newline at end of file