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

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

先决条件

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

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

第 1 步：安装所需的库

为了发出 HTTP 请求，我们将使用 Golang 的标准 net/http 包。此外，我们将使用encoding/json来解析JSON响应。

第 2 步：设置您的 Golang 项目

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

mkdir ziptax-golang && cd ziptax-golang
go mod init ziptax-golang

第三步：编写代码

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

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "net/http"
    "net/url"
)

type Response struct {
    Version       string        `json:"version"`
    RCode         int           `json:"rCode"`
    Results       []Result      `json:"results"`
    AddressDetail AddressDetail `json:"addressDetail"`
}

type Result struct {
    GeoPostalCode     string  `json:"geoPostalCode"`
    GeoCity           string  `json:"geoCity"`
    GeoCounty         string  `json:"geoCounty"`
    GeoState          string  `json:"geoState"`
    TaxSales          float64 `json:"taxSales"`
    TaxUse            float64 `json:"taxUse"`
    TxbService        string  `json:"txbService"`
    TxbFreight        string  `json:"txbFreight"`
    StateSalesTax     float64 `json:"stateSalesTax"`
    StateUseTax       float64 `json:"stateUseTax"`
    CitySalesTax      float64 `json:"citySalesTax"`
    CityUseTax        float64 `json:"cityUseTax"`
    CityTaxCode       string  `json:"cityTaxCode"`
    CountySalesTax    float64 `json:"countySalesTax"`
    CountyUseTax      float64 `json:"countyUseTax"`
    CountyTaxCode     string  `json:"countyTaxCode"`
    DistrictSalesTax  float64 `json:"districtSalesTax"`
    DistrictUseTax    float64 `json:"districtUseTax"`
    District1Code     string  `json:"district1Code"`
    District1SalesTax float64 `json:"district1SalesTax"`
    District1UseTax   float64 `json:"district1UseTax"`
    District2Code     string  `json:"district2Code"`
    District2SalesTax float64 `json:"district2SalesTax"`
    District2UseTax   float64 `json:"district2UseTax"`
    District3Code     string  `json:"district3Code"`
    District3SalesTax float64 `json:"district3SalesTax"`
    District3UseTax   float64 `json:"district3UseTax"`
    District4Code     string  `json:"district4Code"`
    District4SalesTax float64 `json:"district4SalesTax"`
    District4UseTax   float64 `json:"district4UseTax"`
    District5Code     string  `json:"district5Code"`
    District5SalesTax float64 `json:"district5SalesTax"`
    District5UseTax   float64 `json:"district5UseTax"`
    OriginDestination string  `json:"originDestination"`
}

type AddressDetail struct {
    NormalizedAddress string  `json:"normalizedAddress"`
    Incorporated      string  `json:"incorporated"`
    GeoLat            float64 `json:"geoLat"`
    GeoLng            float64 `json:"geoLng"`
}

func getSalesTax(address string, apiKey string) (*Response, error) {
    url := fmt.Sprintf("https://api.zip-tax.com/request/v50?key=%s&address=%s", apiKey, url.QueryEscape(address))

    resp, err := http.Get(url)
    if err != nil {
        return nil, fmt.Errorf("failed to make API request: %w", err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        return nil, fmt.Errorf("unexpected status code: %d", resp.StatusCode)
    }

    var taxResponse Response
    if err := json.NewDecoder(resp.Body).Decode(&taxResponse); err != nil {
        return nil, fmt.Errorf("failed to parse response: %w", err)
    }

    return &taxResponse, nil
}

func main() {
    apiKey := "your_api_key_here".  // Replace with your key
    address := "200 Spectrum Center Dr, Irvine, CA 92618"                  // Example address

    taxInfo, err := getSalesTax(address, apiKey)
    if err != nil {
        log.Fatalf("Error fetching sales tax: %v", err)
    }

    fmt.Printf("Normalized Address: %s\n", taxInfo.AddressDetail.NormalizedAddress)
    fmt.Printf("Address Lat/Lng: %f, %f\n", taxInfo.AddressDetail.GeoLat, taxInfo.AddressDetail.GeoLng)
    fmt.Printf("Rate: %.2f%%\n", taxInfo.Results[0].TaxSales*100)
}

守则解释

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

第 4 步：运行应用程序

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

go run main.go

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

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 集成到您的 Golang 应用程序中非常简单。通过遵循本指南，您可以使用基于地址的准确销售税信息来增强您的申请。更多详情请参考官方文档。

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

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