跳转到主要内容

USPS API的Python封装器

项目描述

Python 3.5, 3.6, 3.7, 3.8 build Code Coverage MIT License


这是一个简单的异步Python封装器,用于USPS API。它是从usps-api项目分叉出来的,以创建异步版本。您不需要处理XML,使用此库即可接收用于跟踪运输、创建运输和验证地址的格式良好的字典。

安装

注意:由于aiopsps尚未在PyPI上发布,因此您需要从源代码进行安装。

要安装usps-api,请使用pip

pip install aiousps

或从源代码安装

python setup.py install

配置

注意:为了使用这些API中的任何一个,您需要注册USPS并获取USERID。对于创建运输端点,您还需要通过电子邮件uspstechnicalsupport@mailps.custhelp.com请求进一步权限,以获取标签API访问权限。

USPS开发者指南可在https://www.usps.com/business/web-tools-apis/general-api-developer-guide.htm找到

用法

跟踪运输

from usps import USPSApi

usps = USPSApi('XXXXXXXXXXXX')
track = usps.track('00000000000000000000')
print(track.result)

创建运输

“create_shipment”函数需要提供目的地和起始地址、重量(以盎司为单位)、服务类型和标签类型。服务类型和标签类型可以在usps/constants.py中找到。默认值为SERVICE_PRIORITYLABEL_ZPL

from usps import USPSApi, Address
from usps import SERVICE_PRIORITY, LABEL_ZPL

to_address = Address(
    name='Tobin Brown',
    address_1='1234 Test Ave.',
    city='Test',
    state='NE',
    zipcode='55555'
)

from_address = Address(
    name='Tobin Brown',
    address_1='1234 Test Ave.',
    city='Test',
    state='NE',
    zipcode='55555'
)
weight = 12  # weight in ounces

usps = USPSApi('XXXXXXXXXXXX', test=True)
label = usps.create_label(to_address, from_address, weight, SERVICE_PRIORITY, LABEL_ZPL)
print(label.result)

验证地址

from usps import USPSApi, Address

address = Address(
    name='Tobin Brown',
    address_1='1234 Test Ave.',
    city='Test',
    state='NE',
    zipcode='55555'
)
usps = USPSApi('XXXXXXXXXXXX', test=True)
validation = usps.validate_address(address)
print(validation.result)

许可

MIT。有关更多详细信息,请参阅许可协议

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分发

此版本没有提供源分发文件。请参阅生成分发存档的教程。

构建分发

aiousps-0.1.3-py3-none-any.whl (13.6 kB 查看哈希值)

上传时间: Python 3

支持者