将 zip.zax 销售税 API 集成到您的 Python 应用程序中

如果您正在构建需要准确计算销售税的应用程序，那么 zip.tax API 是一个出色的集成工具。本指南将引导您了解如何在 Python 应用程序中设置和使用 zip.tax API。

先决条件

开始之前，请确保您具备以下条件：

• Python 基础知识。
• Python 开发环境搭建完毕。
• 来自 zip.tax 的 API 密钥。

第 1 步：安装所需的库

为了发出 HTTP 请求，我们将使用 Python 的标准 requests 包。此外，我们将使用 json 来解析 JSON 响应。

第 2 步：设置您的 Python 项目

创建新的项目目录并初始化新模块：

mkdir ziptax-python && cd ziptax-python

第三步：编写代码

这是一个简单的 Python 应用程序的完整示例，该应用程序查询 zip.tax API 以获取销售税信息。

import requests
import json

class Response:
    def __init__(self, data):
        self.version = data.get("version")
        self.r_code = data.get("rCode")
        self.results = [Result(result) for result in data.get("results", [])]
        self.address_detail = AddressDetail(data.get("addressDetail", {}))

class Result:
    def __init__(self, data):
        self.geo_postal_code = data.get("geoPostalCode")
        self.geo_city = data.get("geoCity")
        self.geo_county = data.get("geoCounty")
        self.geo_state = data.get("geoState")
        self.tax_sales = data.get("taxSales")
        self.tax_use = data.get("taxUse")
        self.txb_service = data.get("txbService")
        self.txb_freight = data.get("txbFreight")
        self.state_sales_tax = data.get("stateSalesTax")
        self.state_use_tax = data.get("stateUseTax")
        self.city_sales_tax = data.get("citySalesTax")
        self.city_use_tax = data.get("cityUseTax")
        self.city_tax_code = data.get("cityTaxCode")
        self.county_sales_tax = data.get("countySalesTax")
        self.county_use_tax = data.get("countyUseTax")
        self.county_tax_code = data.get("countyTaxCode")
        self.district_sales_tax = data.get("districtSalesTax")
        self.district_use_tax = data.get("districtUseTax")
        self.district1_code = data.get("district1Code")
        self.district1_sales_tax = data.get("district1SalesTax")
        self.district1_use_tax = data.get("district1UseTax")
        self.district2_code = data.get("district2Code")
        self.district2_sales_tax = data.get("district2SalesTax")
        self.district2_use_tax = data.get("district2UseTax")
        self.district3_code = data.get("district3Code")
        self.district3_sales_tax = data.get("district3SalesTax")
        self.district3_use_tax = data.get("district3UseTax")
        self.district4_code = data.get("district4Code")
        self.district4_sales_tax = data.get("district4SalesTax")
        self.district4_use_tax = data.get("district4UseTax")
        self.district5_code = data.get("district5Code")
        self.district5_sales_tax = data.get("district5SalesTax")
        self.district5_use_tax = data.get("district5UseTax")
        self.origin_destination = data.get("originDestination")

class AddressDetail:
    def __init__(self, data):
        self.normalized_address = data.get("normalizedAddress")
        self.incorporated = data.get("incorporated")
        self.geo_lat = data.get("geoLat")
        self.geo_lng = data.get("geoLng")

def get_sales_tax(address, api_key):
    try:
        api_url = f"https://api.zip-tax.com/request/v50?key={api_key}&address={requests.utils.quote(address)}"
        response = requests.get(api_url)

        if response.status_code != 200:
            raise Exception(f"Unexpected status code: {response.status_code}")

        response_data = response.json()
        return Response(response_data)
    except Exception as e:
        print(f"Error fetching sales tax: {e}")
        return None

def main():
    api_key = "your_api_key_here"  # Replace with your actual API key
    address = "200 Spectrum Center Dr, Irvine, CA 92618"  # Example Address

    tax_info = get_sales_tax(address, api_key)

    if tax_info:
        print(f"Normalized Address: {tax_info.address_detail.normalized_address}")
        print(f"Address Lat/Lng: {tax_info.address_detail.geo_lat}, {tax_info.address_detail.geo_lng}")
        if tax_info.results:
            print(f"Rate: {tax_info.results[0].tax_sales * 100:.2f}%")

if __name__ == "__main__":
    main()

守则解释

1. API 请求： get_sales_tax 函数使用 API 密钥和地址构造 URL，发出 GET 请求，并解析响应。
2. 响应解析：响应 JSON 已解组，以便轻松访问销售税详细信息。
3. 显示结果： 主要函数打印指定地址代码的标准化地址、纬度/经度和销售税率。您可以使用此处的任何响应值来输出您需要的数据。

第 4 步：运行应用程序

将代码保存到文件（例如main.py），然后运行程序：

python main.py

您应该看到与此类似的输出：

Normalized Address: 200 Spectrum Center Dr, Irvine, CA 92618-5003, United States
Address Lat/Lng: 33.652530, -117.747940
Rate: 7.75%

结论

将 zip.tax API 集成到您的 Python 应用程序中非常简单。通过遵循本指南，您可以使用基于地址的准确销售税信息来增强您的申请。更多详情请参考官方文档。

如果您有任何问题或反馈，请随时在下面发表评论。快乐编码！

以上是将 zip.zax 销售税 API 集成到您的 Python 应用程序中的详细内容。更多信息请关注PHP中文网其他相关文章！