Here you will find the documentation for SkPy, an unofficial Python library for interacting with the Skype HTTP API.
The aim of this library is to provide feature-complete support for Skype for Web. So far, it supports:
contacts: retrieving the contact list and groups, sending and responding to invites, searching the directory
conversations: sending text messages, marking read, rich text formatting, file/image transfers, shared contacts
group chats: creating new conversations, adding/removing members, delegating admins, setting topic/history, join URLs
events: receiving conversation messages, status and endpoint changes
translation API, user settings, credit/subscription info and more
The upstream APIs used here are undocumented and are liable to change, which may cause parts of this library to fall apart in obvious or non-obvious ways.
If you’re looking to create a bot for other Skype users to interact with, consider using the official Microsoft Bot Framework instead.
Note that the protocol and APIs are not feature-complete with other Skype clients – the Skype protocol pages have various notes on what is and isn’t available over the HTTP APIs.
Take a look at the GitHub repository for how to get involved.
Before raising an issue or pull request:
Checkout the latest version of the code to ensure the problem hasn’t already been solved.
Make sure you’re not encountering a server-side issue, particularly with authentication. Try logging into Skype for Web to see where the problem lies.
SKPY_DEBUG_HTTP=1in your environment to output all HTTP requests between the library and Skype’s APIs.
Include some sample code to reproduce a problem, along with a full traceback and HTTP output if relevant.
The documentation (both for SkPy, and the Skype for Web protocol) is a work in progress, but the content is also hosted on GitHub – submissions welcome.
- Logging in
- Working with contacts
- Working with conversations
- Working with messages
- Event processing
- Skype protocol
- Event endpoints
- Contact endpoints
- Conversation endpoints
- Recent changes