Skip to main content

Python SDK for mingdao.com, provides Mingdao OAuth2 authorization and API wrapper.

Project description

api_python
==========

For Python

Install:
========
可以通过 pip 安装:

pip install mingdao

或下载后执行

python setup.py install

进行安装

依赖 requests 库, 如果需要直接运行 demo, 还需要 bottle 库, 可通过下面的命令安装依赖

pip install requests
pip install bottle

Demo:
=====
安装完成后可以通过

python -m mingdao

运行 demo,访问地址为 http://localhost:8000

Usage:
======
请先在 http://open.mingdao.com 注册一个应用,并获取 app_key 和 app_secret

## Config

import mingdao
api = mingdao.API({
'app_key': 你的 app_key(必填),
'app_secret': 你的 app_secret(必填),
'redirect_uri': 你设置的应用回调地址(必填),
'throw_api_error': 在 API 返回错误码时是否抛出异常(可选),
})

## Authorize
多数 API 需首先进行授权,获得 access_token
详情请参阅[明道开发指南](http://open.mingdao.com/Home_document_intro.html):
用户登录后会回调应用的回调地址,并传递一个 code 参数,可用 api.authorize 方法进行授权:

api.authorize(code)

查看授权过期时间:

api.expires_in # 授权有效期
api.expires_at # 过期时间

刷新授权:

api.refresh()

## Call API
可通过 `api.分类名.接口名(参数)` 方式调用 API,access_token, app_key, app_secret 以及 format 参数无需指定。
以动态更新接口 `/post/followed` 为例:

result = api.post.followed({
'keywords': '关键字',
'post_type': 1,
'pagesize': 50,
})

result 为反序列化 API 接口返回的 JSON 字符串后生成的字典对象。
API 接口详情请参阅[明道开发文档](http://open.mingdao.com/Home_document_intro.htm)

Project details


Release history Release notifications

This version
History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mingdao-0.1.4.zip (19.5 kB) Copy SHA256 hash SHA256 Source None Apr 27, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page