提供对package labels.dk Web服务的访问。
Pykkelabels的Python项目详细描述
#皮克勒贝尔斯
用于与pakkelabels.dk web服务交互的pakkelabels.dk php包的python实现。 有关用法和方法的文档,请参见文档[此处](https://www.pakkelabels.dk/integration/api/)。
##兼容性
包和测试都与Python2和3兼容。并在Python2.7、3.4和3.5上进行了测试。
##安装
最简单的方法是使用pip安装包: ` pip install Pykkelabels `
或者,从github下载存储库并将pykkelabels文件夹放入项目文件夹中。
##用法
使用以下命令导入包和伴随的异常: ` from pykkelabels import Pykkelabels, ConnError, PageError `
首先需要登录: ` label = Pykkelabels('api_user', 'api_key') `
这将登录并获取所需的令牌。 令牌随后会自动添加到任何后续调用中。
要查看生成的令牌,可以使用: ` print(label.getToken()) `
###示例:
将所有后丹麦马克标签运送到丹麦: ` labels = label.shipments({'shipping_agent': 'pdk', 'receiver_country': 'DK'}) `
获取特定标签的PDF: ` import base64 base64 = label.pdf(31629) pdf = base64.b64decode(base64) `
###例外情况:
如果与服务器的连接有问题,或者如果返回的数据不可解析,则会引发connerror。 如果服务器返回一个错误,将引发一个pageerror异常,其中包含来自服务器的错误消息。
##贡献
请参阅github贡献指南[此处](https://guides.github.com/activities/contributing-to-open-source/)。
##历史记录
- V0.1:首次工作释放。大部分功能还没有测试。
- v0.1.1:在可能的情况下,向方法添加单元测试
- V0.1.2:制备的PYPI释放
- 添加了更好的错误处理,并添加了自定义异常。增加了对不良输入的测试。实现了更好的pdf生成测试。
- v0.1.4:从pypi版本中删除不需要的文件
- v1.0.0:使包与python 2和3兼容。重命名异常。
- v1.1.0:更好的错误处理
- v1.1.1:设置用户代理
##学分
anders winther brandt的python包
pakkelabels.dk提供的原始php模块
来自pakkelabels.dk的jan christensen的调整
##许可证
麻省理工学院,请参见许可证文件