二. 集成前的準備工作

在開始操作之前，請確保已準備以下內容：

1. 客戶端 ID 與客戶端密鑰

• Client ID 和 Client Secret 是調用 ADP API 的必備憑證。
• 這些信息由 ADP 提供，用于驗證您的身份。

2. 客戶端證書（PFX 文件）

• ADP API 要求使用 PFX 格式的客戶端證書進行身份驗證。

• 注意事項：

  • 當 PFX 文件過期時，ADP API 可能會拋出通用 SSL/TLS 通道錯誤，容易誤判為其他問題。
  • 建議定期檢查證書有效期，確保 API 調用順利。

• 驗證步驟：

  1. 將 PFX 文件導入本地證書存儲。
  2. 使用相同的空密碼進行配置。

三. 將 .cer 和 .key 文件轉換為 PFX 文件

如果您手頭有獨立的 .cer 和 .key 文件，需要將它們合并為一個 .PFX 文件（PKCS#12 格式）以兼容 ADP API。

轉換步驟：

1. 使用 OpenSSL 工具合并證書和私鑰：

openssl pkcs12 -export -out certificate.pfx -inkey private.key -in certificate.cer

2. 設置合適的導出密碼，并妥善保存生成的 certificate.pfx 文件。

完成上述步驟后，即可獲得符合 ADP API 要求的 PFX 證書文件。

四. 成功建立 HTTP 連接

在準備好憑證和 PFX 證書后，您可以通過 ZappySys JSON Source 或 REST API 工具 與 ADP API 建立 HTTP 連接：

• 支持 OAuth 連接管理器配置
• 支持靈活的數據源集成
• 提供分頁、篩選和錯誤處理等高級選項

通過配置正確的 OAuth 參數和 PFX 證書，即可順利實現數據交互。

五. 總結與注意事項

通過本文指導，您可以：

• 了解 ADP API 對 OAuth 和證書的特殊要求
• 成功生成符合要求的 PFX 文件
• 使用 ZappySys 工具快速建立 API 連接

操作建議：

1. 確保 OAuth 參數配置正確，包括 Client ID、Client Secret、回調 URL 等。
2. 定期檢查 PFX 證書的有效期，防止因證書過期導致連接失敗。
3. 在調試 API 調用時，可使用 Fiddler 或類似工具監控請求與響應，確保配置正確。

原文鏈接: https://zappysys.com/blog/connect-adp-api-using-http-connection-oauth-connection/

<code id="9hncr"></code>