POST已開放global-tax-rate-query

全球稅率查詢

依國家、州省、城市或郵遞區號查詢消費稅率，涵蓋目前資料來源支援的 130 多個國家與地區。

呼叫價格

15 匠幣/次

線上除錯

無需寫程式，瀏覽器中直接發起真實請求

接入文件

全球税率查询

按国家、州省、城市或邮编查询消费税率，覆盖当前数据源支持的 130 多个国家和地区。

请求

POST /v1/global-tax-rate-query

鉴权

使用 ToolKK OpenAPI AppKey；上游服务凭证由工具匠服务器安全管理，不会向调用方暴露。

计费

成功调用 15 匠币。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "country": "US",
  "state": "CA",
  "city": "San Francisco",
  "zip": "94105"
}

響應示例

{
  "code": "SUCCESS",
  "data": {
    "country_code": "US",
    "standard_rate": 8.625
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
country	string	US
state	string	CA
city	string	San Francisco
zip	string	94105

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
code	string	SUCCESS
data	object	{...}
data.country_code	string	US
data.standard_rate	number	8.625

curl --request POST \ --url 'https://openapi.toolkk.com/v1/global-tax-rate-query' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "country": "US",\n "state": "CA",\n "city": "San Francisco",\n "zip": "94105"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/global-tax-rate-query" payload = { "country": "US", "state": "CA", "city": "San Francisco", "zip": "94105" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/global-tax-rate-query" payload := []byte("{\n \"country\": \"US\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"country\": \"US\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/global-tax-rate-query")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/global-tax-rate-query'; $payload = "{\n \"country\": \"US\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

全球稅率查詢

線上除錯

接入文件

全球税率查询

请求

鉴权

计费

接入示例程式碼

請求示例

響應示例

請求欄位

響應欄位

Shell 示例

Python 示例

Go 示例

Java 示例

PHP 示例