跳轉到主要內容
包含 application/x-www-form-urlencoded、文字資料與二進位資料的 HTTP 要求。

屬性

Name (名稱)Type (型別)Description (說明)
Urlstring資源的 URL。
Methodstring要求類型(例如 GET 或 POST)。
AuthTokenstring驗證權杖(如果需要外部服務驗證)。
AuthSchemestring驗證機制。
ThrowExceptionOnFailedboolean指定當外部服務回傳錯誤代碼作為 HTTP 回應狀態碼時(即不在 200–299 範圍內),是否應產生例外。如果設定為 False,當外部服務回傳錯誤代碼作為 HTTP 回應狀態碼時,不會產生例外。若要檢視 HTTP 回應狀態碼,請檢查 Status 屬性的值。預設為 True。重要! 如果回應包含錯誤代碼,這表示外部服務運作狀況正常,並且正在對要求傳送回應。如果在傳送 HTTP 要求時發生與服務可用性或網際網路連線狀態相關的錯誤,則無論此屬性的值為何,都會產生程式例外,因為在這種情況下不會提供任何外部服務 HTTP 狀態碼。
Timeoutnumber要求逾時時間(分鐘)。預設為 1 分鐘。重要! 要求逾時值不得大於指令碼執行時間限制(600 秒)。
ResponseTextstring, read-only文字格式的回應結果。
ResponseTypestring, read-only服務傳回的回應類型,例如 “application/json”。
Statusnumber外部服務的 HTTP 回應狀態碼。如果 ThrowExceptionOnFailed 設為 True,錯誤代碼會產生例外並中斷處理作業。錯誤訊息文字可以在技能監控中檢視。

方法

NameDescription
SetHeader(string name, string value);設定此要求的額外 HTTP 標頭。應針對每個標頭名稱呼叫此方法。
Send();傳送 HTTP 要求。
SetFileContent(DocumentExportResult documentExportResult, string mediaType?);初始化以流程為基礎的 HTTP 要求,允許將匯出的資料作為檔案傳遞。所傳遞內容的類型會根據匯出檔案的副檔名自動設定,例如 application/json、application/pdf。如有需要,可以使用選用參數 mediaType 預先設定內容類型。
SetFileContent(BinaryFile binaryFile, string mediaType?);初始化以二進位資料為基礎的 HTTP 要求,可傳遞在建立處理作業時匯入的來源影像檔,或類型為 Picture 的欄位中所包含的影像。所傳遞內容的類型會根據匯入檔案的副檔名自動設定。如有需要,可以使用選用參數 mediaType 預先設定內容類型。
SetSourceFileContent(string mediaType?);初始化以二進位資料為基礎的 HTTP 要求,允許傳遞在建立處理作業時匯入的來源影像檔。所傳遞內容的類型會根據匯入檔案的副檔名自動設定。如有需要,可以使用選用參數 mediaType 預先設定內容類型。重要! 此方法已標記為過時 (deprecated)。它只能存取處理作業中的第一個檔案。您應改用 SetFileContent() 方法。
SetStringContent(string content, ContentEncoding contentEncoding?, string mediaType?);初始化以 string 為基礎的 HTTP 要求。預設情況下,Content-Type 會設為使用 UTF8 編碼的 application/json。如有需要,您可以變更內容和編碼類型。
SetUrlFormEncodedContent(any content);初始化以 JavaScript 物件為基礎的要求內容,並將其編碼為 application/x-www-form-urlencoded。JavaScript 物件應初始化為一組簡單的屬性值,例如:var form = {}; form.grant_type = "password"; form.scope = "openid permissions"; form.client_id = "value of client_id"; form.client_secret = "value of client_secret"; form.password = "Password"; form.username = "User Name"; request.SetUrlFormEncodedContent(form);