Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/yueyoum/social-oauth

OAuth2 for Chinese social sites
https://github.com/yueyoum/social-oauth

Last synced: 4 months ago
JSON representation

OAuth2 for Chinese social sites

Host: GitHub
URL: https://github.com/yueyoum/social-oauth
Owner: yueyoum
License: mit
Created: 2013-03-14T13:27:35.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2016-05-03T03:41:37.000Z (about 8 years ago)
Last Synced: 2024-03-01T04:21:57.977Z (4 months ago)
Language: Python
Size: 158 KB
Stars: 321
Watchers: 30
Forks: 101
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE

Lists

awesome-stars - social-oauth - OAuth2 for Chinese social sites (Python)

README

# socialoauth

Python Package For SNS sites with OAuth2 support

`socialoauth` 专注于中国大陆开放了OAuth2认证的网站

## Feature

* 易于扩展 [参见doc.md](/doc.md)
* 统一的接口

* 各个站点，都有 `uid`, `name`, `avatar`, 属性

QQ 取回的 `avatar` 是40x40尺寸的，其余站点基本都是 48~50的尺寸

* 各个站点，都有统一的 `api_http_get` 和 `api_http_post` 接口

* 统一的错误处理

`api_http_get` 和 `api_http_post` 都可能引发异常，

应用程序只要 `try ... except SocialAPIError as e` 就能得到一致的错误信息：

* `e.site_name` 哪个站点发生错误
* `e.url` 发生错误是请求的url
* `e.api_error_msg` 由站点返回的错误信息 or urllib2 的错误信息

## Supported sites

* 人人
* 腾讯
* 豆瓣
* 新浪微博
* 网易微博
* 搜狐微博
* 百度
* 开心网
* 淘宝
* 微信

## Contributors

Thanks for this guys

[Jiequan](https://github.com/Jiequan)

[smilekzs](https://github.com/smilekzs)

[andelf](https://github.com/andelf)

[zxkane](https://github.com/zxkane)

[yuanxu](https://github.com/yuanxu)

## Install

```bash
pip install socialoauth

# or

git clone https://github.com/yueyoum/social-oauth.git
cd social-oauth
python setup.py install
```

## Example

快速体验 socialoauth

```bash
git clone https://github.com/yueyoum/social-oauth.git
cd social-oauth/example
cp settings.py.example settings.py

# 在这里按照你的情况修改settings.py

python index.py
```

如何配置 settings.py ? [参见doc.md](/doc.md)

现在用浏览器打开对应的地址，就能体验相应的功能。

下面是我用人人网帐号登录的过程：

##### 初始情况，首页只有一个 login 链接

![step1](http://i1297.photobucket.com/albums/ag23/yueyoum/x1_shadowed_zpsac1e046a.png)

##### 点击后，根据settings.py中的设置，显示可用的认证网站

![step2](http://i1297.photobucket.com/albums/ag23/yueyoum/x2_shadowed_zps47bd6fd8.png)

##### 我用人人网帐号进行测试，点击后，转到人人登录认证的界面

![step3](http://i1297.photobucket.com/albums/ag23/yueyoum/x4_shadowed_zps6aed31ec.png)

##### 认证完毕后，就会显示用户的名字和小头像。
example中有个简单的session机制，
此时再打开首页（不关闭浏览器）就不用再登录，会直接显示名字和头像

![step4](http://i1297.photobucket.com/albums/ag23/yueyoum/x3_shadowed_zpse6a0f575.png)

## Document

[参见doc.md](/doc.md)

## 吐槽

* 新浪微博，腾讯, 开心网的文档是最好的。
* 人人网文档虽然内容丰富，但层次略混乱
* 豆瓣文档太简陋
* 搜狐文档就是个渣！！！都不想添加搜狐支持了
* 发现一些文档和实际操作有出入，主要是文档里说的必要参数，不传也一样工作

* [腾讯][tocao_tencent_1] 文档里说取code的时候，state 必须参数，但发现不传一样
* [搜狐][tocao_souhu_1] 和上面一样， wrap_client_state 参数

[tocao_tencent_1]: http://wiki.opensns.qq.com/wiki/【QQ登录】使用Authorization_Code获取Access_Token
[tocao_souhu_1]: http://open.t.sohu.com/en/使用Authorization_Code获取Access_Token
[Jiequan]: https://secure.gravatar.com/avatar/1fc3c2ed714e2c2a26822ede8a927eac?s=50&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png
[smilekzs]: https://secure.gravatar.com/avatar/405626e107e40527578e65b05a5f7541?s=50&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png
[andelf]: https://secure.gravatar.com/avatar/0478b87ec69ce7ce034d370f326c50aa?s=50&d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png