在開始使用 API 之前,您應該驗證以建立工作階段。Authentication:
驗證:
啟動工作階段的 2 種方式:
- 使用您的 API 金鑰、登入名稱和密碼詳細資料;
- 使用您的 API 金鑰、登入名稱和加密密碼詳細資料。
- API 金鑰、登入名稱和密碼詳細資料。POST /session 端點中的 encryptionKey 參數的值 = false
- 在這裡,您應該簡單地使用 POST /session 端點,並在 X-CAP-API-KEY 標頭中提及平台設定 API 金鑰中收到的訊息,在識別碼和密碼參數中提及登入名稱和密碼資料。 - API 金鑰、登入名稱和加密密碼詳細資料。POST /session 端點中的 encryptionKey 參數的值 = true
- 首先,您應該使用 GET /session/encryptionKey 並在 X-CAP-API-KEY 標頭中提及在平台的設定 API 金鑰中產生的金鑰。作為回應,您將收到 encryptionKey 和時間戳參數;
- 使用收到的 encryptionKey 和時間戳參數,您應該使用 AES 加密方法加密您的密碼。
- 前往 POST /session 端點,為 encryptionKey 參數設定 true 值,並在 X-CAP-API-KEY 標頭中提及平台設定 API 金鑰中收到的訊息,在識別碼和密碼參數中提及登入名和先前加密的密碼資料。
啟動工作階段後,您將在回應標頭中收到 CST 和 X-SECURITY-TOKEN 參數。 這兩個令牌都將在您發送的每個請求的標頭中使用。