跳转到主要内容
包含 application/x-www-form-urlencoded、文本数据和二进制数据的 HTTP 请求。

属性

NameTypeDescription
Urlstring资源的 URL。
Methodstring请求类型(例如 GET 或 POST)。
AuthTokenstring身份验证令牌(如果需要对外部服务进行身份验证)。
AuthSchemestring身份验证机制。
ThrowExceptionOnFailedboolean指定当外部服务返回错误代码作为 HTTP 响应状态(即不在 200–299 范围内)时,是否应抛出异常。如果设置为 False,则当外部服务返回错误代码作为 HTTP 响应状态时,不会抛出异常。若要查看 HTTP 响应代码的状态,请检查 Status 属性的值。默认设置为 True。重要! 如果响应包含错误代码,这意味着外部服务运行正常,并且正在对请求发送响应。如果在发送 HTTP 请求时发生与服务可用性或互联网连接状态相关的错误,则无论此属性的值为何,都会生成程序异常,因为在这种情况下不会提供外部服务的 HTTP 状态代码。
Timeoutnumber请求超时时间(分钟)。默认设置为 1 分钟。重要! 请求超时值不能大于脚本运行时限制(600 秒)。
ResponseTextstring, 只读响应结果的文本形式。
ResponseTypestring, 只读服务返回的响应类型,例如 “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 预先设置内容类型。重要! 此方法已弃用。它只能访问此事务的第一个文件。建议改用 SetFileContent() 方法。
SetStringContent(string content, ContentEncoding contentEncoding?, string mediaType?);初始化基于字符串的 HTTP 请求。默认情况下,Content-Type 被设置为使用 UTF-8 编码的 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);