存取驗證

為確保只有具備合法使用案例的企業才能存取其他企業的商業資料，當企業建立或認領的應用程式或尚未與企業連結的商業應用程式呼叫某些 API 端點時，這些 API 端點會執行驗證檢查。如果建立、認領或連結應用程式的企業已驗證為技術供應商，端點就會正常處理要求。然而，如果企業尚未驗證為技術供應商，則端點會拒絕呼叫並傳回錯誤。

存取驗證是我們用來判定企業是否做為技術供應商來營運的程序。

哪些企業需要存取驗證？

任何企業所建立或認領的應用程式若要供其他企業使用且需要下列任何權限，該企業必須先驗證為技術供應商，其他企業才能使用該應用程式。

請注意，存取驗證與應用程式審查和權限存取層級無關。

權限

驗證檢查

當企業認領的應用程式呼叫需要上列任何權限的端點時，端點會先檢查授予權限的用戶對該應用程式本身是否具有角色。如果用戶對應用程式具有角色，端點會接受呼叫並繼續處理要求。

然而，如果用戶對應用程式不具有角色，則端點會檢查認領應用程式的企業是否已驗證為技術供應商。如果企業已驗證為技術供應商，端點會正常處理要求，否則會拒絕呼叫並傳回下列錯誤：

• 錯誤代碼：100
• 說明：Unsupported get request. Object with ID {object-id} does not exist, cannot be loaded due to missing permissions, or does not support this operation.

如需錯誤代碼的詳細資訊，請參閱行銷 API 錯誤代碼說明文件。

請注意，驗證檢查執行的對象是認領應用程式的企業，但是只有在企業認領的應用程式呼叫已實作驗證檢查的端點時才會觸發。這表示一旦企業驗證為技術供應商，其認領的任何應用程式都會通過驗證檢查。

如何完成存取驗證

如果尚未驗證為技術供應商的企業認領新的應用程式，每當應用程式管理員要求上列任何權限的進階存取權限時，該企業的商業帳號管理員就會收到要求進行存取驗證的電子郵件通知。

電子郵件會包含驗證表單的連結，但也可以從應用程式主控板前往基本 > 驗證 > 存取驗證面板存取該表單。

若要完成驗證，必須由具有商業帳號管理員存取權限的任何用戶，針對該企業如何使用其他企業的資料來為這些企業提供服務，進行分類和說明。

商業帳號管理員完成程序後，我們會在大約 5 天內做出決定。

如果將企業驗證為技術供應商，商業帳號管理員會收到確認電子郵件，而應用程式管理員會收到確認開發人員重要通知。已驗證的企業不需要再次驗證，但在某些情況下，企業可能會暫時失去已驗證狀態。

如果企業的技術供應商驗證遭拒絕，商業帳號管理員會收到拒絕電子郵件，而應用程式管理員會收到拒絕開發人員重要通知，如果應用程式用戶在發出呼叫的應用程式上沒有任何角色，則對需要上述權限的端點發出的所有呼叫都會失敗。

如果遭拒絕的企業變更使用案例，商業帳號管理員可以再次完成該程序供重新審查。

必要條件

商業帳號管理員必須達到下列條件，才能開始進行存取驗證程序：

• 商業帳號管理員必須完成商家驗證
• 商業帳號不得有任何限制

現有企業

如果企業已認領其他企業所使用且需要上述任何權限的應用程式，該企業的商業帳號管理員會自動收到要求進行存取驗證的電子郵件。應用程式管理員也會收到有關此要求的開發人員重要通知。

電子郵件發出後，商業帳號管理員將有 60 天的時間來完成驗證程序。如果未在 60 天內完成該程序，對需要上述任何權限的端點發出的所有呼叫將逐漸受到驗證檢查。

失去已驗證狀態

在下列情況下，已驗證為技術供應商的企業會視為尚未驗證：

一旦這些情況反轉，企業就會自動再次視為已驗證的技術供應商。

另請參閱

• 技術供應商