d8f13837d9
Bots are not part of what we distribute, so put them in the repo root. We also updated some of the bots to use relative path names. (imported from commit 0471d863450712fd0cdb651f39f32e9041df52ba)
64 lines
2.1 KiB
Plaintext
64 lines
2.1 KiB
Plaintext
#### Dependencies
|
|
|
|
The Humbug API Python bindings require the following Python libraries:
|
|
|
|
* simplejson
|
|
* requests (version >= 0.12 and << 1.0.0)
|
|
|
|
#### Using the API
|
|
|
|
For now, the only fully supported API operation is sending a message.
|
|
The other API queries work, but are under active development, so
|
|
please make sure we know you're using them so that we can notify you
|
|
as we make any changes to them.
|
|
|
|
The easiest way to use these API bindings is to base your tools off
|
|
of the example tools under api/examples in this distribution.
|
|
|
|
If you place your API key in `~/.humbugrc` the Python API bindings will
|
|
automatically read it in. The format of the config file is as follows:
|
|
|
|
[api]
|
|
key=<api key from the web interface>
|
|
email=<your email address>
|
|
|
|
You can obtain your Humbug API key from the Humbug settings page.
|
|
|
|
A typical simple bot sending API messages will look as follows:
|
|
|
|
At the top of the file:
|
|
|
|
# Make sure the Humbug API distribution's root directory is in sys.path, then:
|
|
import humbug
|
|
humbug_client = humbug.Client(email="your_email@example.com")
|
|
|
|
When you want to send a message:
|
|
|
|
message = {
|
|
"type": "stream",
|
|
"to": ["support"],
|
|
"subject": "your subject",
|
|
"content": "your content",
|
|
}
|
|
humbug_client.send_message(message)
|
|
|
|
Additional examples:
|
|
|
|
client.send_message({'type': 'stream', 'content': 'Humbug rules!',
|
|
'subject': 'feedback', 'to': ['support']})
|
|
client.send_message({'type': 'private', 'content': 'Humbug rules!',
|
|
'to': ['user1@example.com', 'user2@example.com']})
|
|
|
|
send_message() returns a dict guaranteed to contain the following
|
|
keys: msg, result. For successful calls, result will be "success" and
|
|
msg will be the empty string. On error, result will be "error" and
|
|
msg will describe what went wrong.
|
|
|
|
#### Sending messages
|
|
|
|
You can use the included `api/bin/humbug-send` script to send messages via the
|
|
API directly from existing scripts.
|
|
|
|
humbug-send hamlet@example.com cordelia@example.com -m \
|
|
"Conscience doth make cowards of us all."
|