接口路徑
除了下面詳述的身份驗(yàn)證之外,您可以向以下基本 URL發(fā)出Eggplant Web Performance Analyzer API 請(qǐng)求:
https://api.pa.eggplant.cloud/pa/v1
請(qǐng)求必須使用 HTTPS。請(qǐng)注意,/v1 是指正在使用的 API 的版本。
驗(yàn)證
要訪問 API,您必須設(shè)置一個(gè)客戶端,該客戶端為您提供客戶端 ID 和機(jī)密,您的應(yīng)用程序使用這些 ID 和密鑰生成身份驗(yàn)證(承載)令牌。您向 API 發(fā)出的每個(gè)請(qǐng)求都使用不記名令牌。
您可以在應(yīng)用程序中嵌入客戶端 ID 和密鑰。永遠(yuǎn)不需要在您的客戶端應(yīng)用程序中包含您的登錄用戶名和密碼。
您在客戶端憑據(jù)門戶中管理您的客戶端信息(客戶端 ID 和客戶端機(jī)密對(duì)),這確保您始終可以控制哪些客戶端應(yīng)用程序以您的用戶權(quán)限運(yùn)行。您可以隨時(shí)撤消訪問權(quán)限。
創(chuàng)建客戶端
使用您的常規(guī)門戶登錄用戶名和密碼登錄到Client Credentials 門戶。
在添加客戶端部分創(chuàng)建您的客戶端 ID 和客戶端密鑰。輸入客戶端的描述,然后點(diǎn)擊Generate Keys。
記下生成的客戶端 ID 和客戶端密鑰。您現(xiàn)在可以注銷客戶端憑據(jù)門戶,因?yàn)?API 請(qǐng)求不需要它。
使用您生成的 client_id 和 client_secret 來請(qǐng)求不記名令牌。
要求
身份驗(yàn)證是通過標(biāo)準(zhǔn)的 HTTP 基本身份驗(yàn)證進(jìn)行的,其中請(qǐng)求標(biāo)頭需要包含一個(gè) base64 編碼的client_id和client_secret字符串,用冒號(hào)分隔。
例如,如果您的 client_id 是 client 而您的 client_secret 是 secret,那么您將使用 base64對(duì)整個(gè)字符串client:secret進(jìn)行編碼,即 Y2xpZW50OnNlY3JldA==
回復(fù)
參數(shù)
如果您嘗試使用已過期的不記名令牌,或者在客戶端已被撤銷的情況下,您將看到HTTP 401 未授權(quán)響應(yīng),并且需要如上所述重新驗(yàn)證或設(shè)置新客戶端。
使用領(lǐng)域
對(duì) API 的所有請(qǐng)求都必須包含要從中獲取數(shù)據(jù)的領(lǐng)域的 ID 。您在登錄 Portal Hub 時(shí)選擇的 Performance Analyzer 帳戶等同于您在使用 API 時(shí)將引用的領(lǐng)域。
該客戶端憑證門戶網(wǎng)站列出了您可以訪問每個(gè)帳戶的境界ID:
在本例中,Acme Production 帳戶的領(lǐng)域?yàn)?12345,可用于任何后續(xù) API 請(qǐng)求。
如果要以編程方式識(shí)別用于特定帳戶的領(lǐng)域的 ID,可以按如下方式向 API 發(fā)出請(qǐng)求:
要求
使用Eggplant Web Performance Analyzer的 API 時(shí),服務(wù)始終為 6,因此請(qǐng)使用它來查詢您的領(lǐng)域。
回復(fù)