Python的Cardberg服务绑定
cardberg的Python项目详细描述
Python的Cardberg绑定
用于Cardberg的API处理礼品卡的Python库。在
绑定当前允许您:
- 获取特定卡上的信息
- 在卡上创建特定交易
有关Cardberg API的详细信息,请访问their website。如果您觉得需要涵盖其他API方法,请打开问题或创建请求。在
设置
您可以使用pip
安装此软件包:
pip install cardberg
如果您喜欢pipenv
,请使用:
要从源安装,请运行:
python setup.py install
要使API客户机正常工作,您需要python2.7+或python3.4+。在
要从项目中通过requirements
文件安装,请在更新依赖项之前添加以下内容:
git+git://github.com/palosopko/cardberg-python.git#egg=cardberg
使用
你需要先从用户提供的身份验证和信息库处理共享信息。在
import cardberg
cardberg.api_credentials = ("partner_id", "shared_secret")
{cd4{str}是通过调用{str}来获取信息的。该方法返回一个Card
对象,该对象包括id
、name
、surname
、status
以及可用的credits
和points
。在这个Card
对象上,我们可以创建一个事务(无论是正的还是负的),方法是使用事务类型、事务的十进制值和可选的bill ID来调用create_transaction()
方法以供进一步参考。在
可能的交易类型是“积分”或“积分”,这取决于我们使用的预算。如果你想借记(例如你的用户正在买东西),那么就提供一个负值。在
示例:
import cardberg
from decimal import Decimal
cardberg.api_credentials = ("partner_id", "shared_secret")
card = cardberg.Card.get("D1nd17h")
card.create_transaction(
cardberg.Card.TRANSACTION_CREDITS,
Decimal("-1.00")
)
贡献
- 检查是否存在未解决的问题,或者为功能请求或错误打开新问题。在
- 分叉存储库并对主分支(或其分支)进行更改。在
- 发送请求。在
发展
在所有受支持的Python版本上运行所有测试:
make test
用以下方式运行皮棉:
make lint
客户端库使用黑色作为代码格式。在提交PRs之前,代码必须用黑色格式化。运行格式化程序:
make fmt
变更日志
v0.2.0:2019年10月3日
Python3的兼容性、代码格式被黑色覆盖以及各种小的修复和形式上的更改使一切变得更好。在
v0.1.1:2016年3月21日
增加了从Cardberg的API返回的学分和点数的四舍五入到小数点后两位。在
v0.1.0:2016年3月14日
支持card_info
和create_transaction
API方法的初始版本。在
- 项目
标签: