使用指南

本篇章將幫助您快速了解和使用我們Thordata的公共API功能，以下步驟將引導您如何進行API的使用。

一、獲取賬戶sign及apiKey參數值

1. 通過 儀表板 >> 菜單 >> 我的賬戶 中獲取您的sign參數值

sign參數是您Thordata賬戶的唯一標識，無法更換

1. 通過 儀表板 >> 設置 >>賬戶詳細資料 中獲取您的apiKey參數值

apiKey參數是您執行API請求時需要驗證的參數，在儀表板處可以手動修改

二、代碼示例

以下是一份可以在Python3的終端環境下直接執行ISP代理查詢過期時間API的完整代碼示例

import requests


sign = "请填写您的sign"
apiKey = "请填写您的apiKey"

url = "https://api.thordata.com/api/gateway/queryTimeIsp"
headers = {"sign": sign, "apiKey": apiKey, "Content-Type":"application/x-www-form-urlencoded"}

request_body = {
    "ips":"123.123.123.123"
}

response = requests.post(url, headers=headers, data=request_body)
print(response.text)

如果您想進一步了解上述代碼是如何構建的，您可以繼續閱讀以下詳細步驟說明

定義變量

sign和apiKey為需要您替換的參數信息

sign = "请填写您的sign"
apiKey = "请填写您的apiKey"

構建header

設置API的URL和請求頭部信息

url = "https://api.thordata.com/api/gateway/queryTimeIsp"
headers = {"sign": sign, "apiKey": apiKey, "Content-Type":"application/x-www-form-urlencoded"}

構建body

根據API接口提供參數進行替換（部分API接口沒有body參數，使用時可以直接刪除此段代碼）

request_body = {
    "ips":"123.123.123.123"
}

發送請求並打印API響應內容

response = requests.post(url, headers=headers, data=request_body)
print(response.text)

三、返回結果

{
    "code": 200,
    "data": [
        {
            "ip": "123.123.123.123",
            "expire_time": 1735798456
        }
    ],
    "msg": "ok"
}