Skip to content
Python module for Pingdom's RESTful API
Python
Find file
Latest commit 41d155f Mar 28, 2011 @drcraig Add license text
Failed to load latest commit information.
README.rst Initial commit Mar 28, 2011
pingdom.py Add license text Mar 28, 2011

README.rst

Python Module for Pingdom REST API

Description

Simple Python wrapper for the Pingdom REST API.

This module does not support the soon-to-be obsolete Pingdom SOAP API. See python-pingdom for the SOAP interface.

Dependencies

None beyond the Python standard library.

Usage

Instantiate:

import pingdom
p = pingdom.Pingdom(username=YourUserName, password=YourPassword, appkey=YourAppKey)

Call an arbitrary method as described in the API docs:

p.method(url='method/url/', method="GET/POST/PUT/etc", parameters={'name':'value', })

Example methods:

# List checks
p.method('checks')

# Modifiy a check, in this case, pause it
p.method('checks/CHECK_ID_NUM/', method='PUT', parameters={'paused': True})

Some shortcut methods that were useful to me:

# Get checks by name instead of number
p.check_by_name('my check name')

# Pause and unpause a check by name
p.pause_check('my check name')
p.unpause_check('my check name')

# Average Response Time
p.avg_response(CHEKC_ID_NUM)

# Average Response Time for the last 15 minutes
p.avg_response(CHEKC_ID_NUM, minutes_back=15)

# Average Response Time for the last 15 minutes in the US
p.avg_response(CHEKC_ID_NUM, minutes_back=15, country='US')
Something went wrong with that request. Please try again.