gsxws

Library for communicating with GSX Web Services API.


Keywords
gsx, python, apple, gsx-api, macadmins, soap
License
BSD-3-Clause
Install
pip install gsxws==0.94

Documentation

Introduction

gsxws is a Python library designed to work with Apple's GSX Web Services API. The goal is for it to support all the features of the API. Currently it supports most of them.

Please consult the GSX API documentation (Testing, Production) for more details.

Requirements

  • Python 2.7 or later
  • contents of requirements.pip
  • GSX client certs and valid Apple ID with access to GSX Web Services

Installation:

pip install gsxws

... or grab the latest dev version:

pip install -U -e git+git://github.com/filipp/py-gsxws.git#egg=gsxws

Usage

It goes a little something like this:

# check warranty status
import os
import gsxws
os.environ['GSX_CERT'] = '/path/to/gsx/client/cert.pem'
os.environ['GSX_KEY'] = '/path/to/gsx/client/cert_private_key.pem'
gsxws.connect(apple_id, sold_to)
mac = gsxws.Product('70033CDFA4S')
mac.warranty()
# get available parts for this machine
mac.parts()

Check the tests folder for more examples.

FAQ

  • Q: My script keeps prompting me for the private key passphrase - how could I automate this?

  • A: One way would be to remove the passphrase from the key:

    openssl rsa -in privatekey.pem -out privatekey.nopass.pem