Skip to main content

愉快调用yiban Api

Project description


## 介绍
yibanApi 是一个易班app开发接口框架。主要是为了愉快地调用API。

## 开始

+ <code>pip install yibanApi</code>
+ 配置应用基本配置Config
+ 请求用户授权获取令牌code
+ 利用code 和 Config 实例化AccessToken
+ 开始根据API文档愉快地定义自己的API函数

以下通过一个应用flask例子具体说明

## 例子

```
#获取用户信息的例子

class Config(object):

AppID = ""
AppSecret = ""
Redirect_uri = "myhost/redirect"
STATE = "any_random_str"

from flask import Flask, request, redirect

from yibanApi import AccessToken, api

app = Flask(__name__)

@app.route('/')
def index():
at = AccessToken(Config)
return redirect(at.init_url)


@app.route('/redirect')
def user_info():

#获取令牌code
__code = request.args.get("code")

#利用code 和 Config 实例化AccessToken
at = AccessToken(code=__code, Config)

#开始使用装饰器@at.access_by_token 和api定义自己的函数
@at.access_by_token
def user_me(access_token):
return api.user.me.get(access_token=access_token)

return user_me()

if __name__ == '__main__':
app.run()
```

## 说明
与易班开发文档API接口具有一致性,即:

如果接口地址为:

https://openapi.yiban.cn/path

请求方法为: method

请求参数除了access_token为:

arg1

arg2

那么在实例化AccessToken后可以通过这样定义函数:
```
@at.access_by_token
def my_func(access_token):
return api.path.method(access_token=access_token,
arg1=value1,
arg2=value2)

```

以下通过几个示例说明:
eg:

1.
```
接口说明:
获取当前用户基本信息。

接口地址:
https://openapi.yiban.cn/user/me
GET请求
返回json
接口限制:
授权需要:是
访问权限:无限制
频次限制:是

请求参数:
access_token 必填 用户授权凭证
```

```
根据接口地址和请求方式,可以这样写:
@at.access_by_token
def user_me(access_token):
return api.user.me.get(access_token=access_token)

```
2.
```
接口说明:
开发者主动取消指定用户的授权。

接口地址:
https://openapi.yiban.cn/oauth/revoke_token
POST请求(form-data方式)
返回json
接口限制:
授权需要:否
访问权限:无限制
频次限制:无限制

请求参数:
client_id 必填 应用appkey
access_token 必填 待注销的授权凭证
```

```
根据接口地址和请求方式,可以这样写:
@at.access_by_token
def revoke(access_token):
return api.oauth.revoke_token.post(access_token=access_token,
client_id="填写你的client_id")

```

3
```
接口说明:
删除指定好友。

接口地址:
https://openapi.yiban.cn/friend/remove
GET请求
返回json
接口限制:
授权需要:是
访问权限:无限制
频次限制:是

请求参数:
access_token 必填 用户授权凭证
yb_friend_uid 必填 待删除好友的易班用户ID
```

```
根据接口地址和请求方式,可以这样写:
@at.access_by_token
def remove(access_token):
return api.friend.remove.get(access_token=access_token,
yb_friend_uid="待删除好友的易班用户ID")
```
Keywords: 愉快调用yiban Api
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8

Project details


Download files

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

Source Distribution

yibanApi-0.0.15.tar.gz (5.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page