檢索您的商店
您可以使用 Web Bot Auth 安全地授權自有爬蟲程式、指令碼或工具存取您公開的 Shopify 網路商店。Web Bot Auth 採用 HTTP 訊息簽章，此簽章可在您的 Shopify 管理介面中產生。您必須在每個要求的 HTTP 標頭中納入此簽章，如此一來，系統才能驗證要求是否來自經過授權的來源。
您可以將簽章與自動化的第一方或第三方工具搭配使用，這些工具會存取您的網路商店，以進行無障礙功能與 SEO 稽核、自動化測試、資料分析及類似的使用情境。搜尋引擎與大型語言模型 (LLM) 可以在不使用簽章的情況下，為您的商店建立索引。
簽章功能
簽章具有以下特性：
- 安全驗證：您可以為爬蟲程式產生具備密碼編譯安全性的簽章。
- 到期日控制：您可以設定簽章在特定期間後到期。最長期間為 3 個月。
- 集中管理：您可以在單一位置管理與檢視所有簽章。
- 自訂命名：您可以為每個簽章設定自訂名稱，以便進行識別。
- 網域範圍限定：每個簽章皆用於特定網域，且該網域必須連結至您的 Shopify 商店。
建立簽章的考量
在建立並使用簽章之前，請先留意以下事項：
- 使用簽章檢索商店僅供分析線上店面。由於具備額外的結帳頁面安全層級，簽章無法授予 Shopify 結帳頁面 的存取權。
- 為簽章使用清楚、具描述性的名稱。
- 簽章會自動到期且無法延長。簽章到期後，請建立新的簽章並更新您的工具。
- 每個簽章僅用於一個網域，因此必須指定該簽章要用在哪個已連結的網域。您只能選取已連結至 Shopify的網域。
建立簽章
您可以直接在 Shopify 管理介面建立並管理簽章。
在您的 Shopify 管理介面中，前往 網路商店 > Preferences。
在 檢索器存取 區段，按一下 建立簽章。
在 名稱 欄位中，輸入簽章的描述性名稱。
在 網域 欄位中，選取您要將此簽章用於的網域。
在 有效期間 區段中，選取簽章的有效期間。
按一下 建立。
選用：若要複製新建立的 Signature-Input 與 Signature 值，請按一下每個值旁的 複製。
簽章到期後便不再有效。您無法續用已到期的簽章，但可以建立新的簽章。
為要求新增簽章
您可以複製簽章，然後將其新增至要求的 HTTP 標頭中。每個簽章都包含 3 個您必須納入的 HTTP 標頭。
| 標頭名稱 | 標頭值 |
|---|---|
| Signature-Input | 加入您的簽章輸入值。 |
| Signature | 加入您的簽章值。 |
| Signature-Agent | Signature-Agent 的值是一個字串，內容為代理程式的有效的統一資源識別碼 (URI)。此值請使用 "https://shopify.com" (包含引號)。 |
如需新增自訂標頭的操作說明，請參閱以下文件：
檢視簽章
您可以在 Shopify 管理介面中檢視現有簽章的下列資訊：
- 簽章名稱
- 關聯網域
- Signature-Input 和 Signature 值的前幾個字元
- Signature-Agent 值
- 簽章到期日與狀態
在您的 Shopify 管理介面中，前往 網路商店 > Preferences。
在「爬蟲程式存取」區段中，檢閱有關您簽章的資訊。
簽章疑難排解
選取簽章問題，依照疑難排解步驟操作。
疑難排解驗證問題
如果您的檢索器收到速率限制錯誤，代表簽章無效。請確認以下事項：
- 確認您在 HTTP 標頭中使用正確的簽章格式。
- 請確保每次要求都隨附 Signature-Input、Signature、Signature-Agent 標頭。
- 確認簽章尚未過期。請在 Shopify 管理介面檢視到期日。
- 請檢索與簽章關聯的網域。
復原遺失的簽章
若您遺失簽章，可透過完成下列步驟進行復原：
- 在您的 Shopify 管理介面 中，前往 網路商店 > Preferences。
- 在 檢索器存取 區段中，於清單中找到您的簽章。
- 點擊「複製」，將「Signature-Input」、「Signature」和「Signature-Agent」的值複製到剪貼簿。