跳转到主要内容
向 API 接口发出 HTTP POST 请求。

必需的参数

  • url: 目标 URL。

可选的参数

  • authentication: 用于设置手动生成的授权头,例如 bearer token。
  • authscheme: 要使用的授权机制。仅当提供用户和密码时相关。允许的值为 BASIC、DIGEST、NONE 和 NTLM。默认值为 BASIC。
    • user: 如果 authscheme 参数设置为 NONE 以外的其它值,则使用该用户名进行身份验证。
    • password: 如果 authscheme 参数设置为 NONE 以外的其它值,则使用该密码进行身份验证。
  • charset: 交换/传输的数据的字符集。默认值为 UTF-8。
  • client_id: 客户端 ID。仅限 OAuth 1.0。
  • client_secret: 客户密钥。仅限 OAuth 1.0。
  • contenttype: POST 的内容类型。默认值为 application/x-www-form-urlencoded。
  • cookie:*: 任何要添加到请求中的 cookie。
  • firewall_port: 防火墙的端口号。
  • firewall_server: 防火墙的 IP 地址或主机名。
    • firewall_user: 向防火墙进行身份验证的用户 ID。
    • firewall_password: 向防火墙进行身份验证的密码。
  • firewall_type: 防火墙的类型。允许的值为 NONE、TUNNEL、SOCKS4 和 SOCKS5。默认值为 NONE。
  • followredirects: 是否遵循 HTTP 重定向。允许的值为 TRUE 或 FALSE。默认值是 TRUE。
  • formencoding: 通过 paramname# 和 paramvalue# 传递参数时,要使用的编码类型。允许的值为 URLENCODED 和 FORMDATA。默认值为 URLENCODED。
  • header:name#: 与请求一起传递的每个自定义头的名称。
  • header:value#: 与请求一起传递的每个自定义头的值。
  • httpversion: 要使用的 HTTP 协议版本。允许的值为 1.0 或 1.1。默认值为 1.1。
  • internalconfig#: 设置一个内部配置设置。
  • logfile: 记录请求和响应数据的文件的完整路径。必须与 verbosity 结合使用。
  • paramname#: 与请求一起传递的每个参数的名称。
  • paramvalue#: 与请求一起传递的每个参数的值。
  • postdata: 要包含在 POST 中的数据。使用 file://,后跟文件路径来发布文件的内容。
  • proxy_auto: 是否应从 Windows 系统设置中检测代理。这优先于其它代理设置,在 Java 中不可用。允许的值为 TRUE 或 FALSE。默认值为 FALSE。
  • proxy_authscheme: 代理服务器的认证方案。允许的值为 BASIC、DIGEST、PROPRIETARY、NONE 和 NTLM。默认值为 BASIC。
  • proxy_authtoken: 代理身份验证令牌。
  • proxy_port: 代理服务器的端口号。
  • proxy_server: 用于请求的代理服务器的 IP 地址或主机名。
    • proxy_user: 向代理服务器进行身份验证的用户 ID。
    • proxy_password: 与代理服务器进行身份验证的密码。
  • proxy_ssltype: 代理服务器的 TLS/SSL 类型。允许的值为 AUTO、ALWAYS、NEVER 和 TUNNEL。默认值为 AUTO。
  • sign_method: 用于计算 OAuth 1.0 签名的签名方法。允许的值为 HMAC-SHA1 和 PLAINTEXT。默认值为 HMAC-SHA1。
  • sslcert: 要从服务器接受的 TLS/SSL 证书。这可以采用完整 PEM 证书,包含证书的文件路径,公钥,MD5 指纹或 SHA-1 指纹的形式。 指定证书以外的任何证书都将被拒绝。 如果未指定,此值默认为 TRUSTED,这意味着仅接受系统信任的证书。 如果设置为 *,则接受任何证书。
  • sslclientcert: 客户端证书的名称。
  • sslclientcerttype: 客户端证书的存储类型。允许的值为 USER、MACHINE、PFXFILE、PFXBLOB、JKSFILE、JKSBLOB、PEMKEY\_FILE、PEMKEY\_BLOB、PUBLIC\_KEY\_FILE、PUBLIC\_KEY\_BLOB、SSHPUBLIC\_KEY\_BLOB、P7BFILE、P7BBLOB、SSHPUBLIC\_KEY\_FILE、PPKFILE、PPKBLOB、XMLFILE 和 XMLBLOB。
  • sslclientcertpassword: 客户端证书的密码。
  • sslclientcertsubject: 客户端证书的主题。使用星号会找到存储中的第一个证书。
  • timeout: 操作完成的超时时间(以秒为单位)。零(0)表示没有超时。默认值为 60。
  • token: OAuth 的请求令牌。
  • token_secret: 请求令牌密钥。仅限 OAuth 1.0。
  • verbosity: 日志文件的详细程度,从 1(最不详细)到 5(最详细)。
  • version: OAuth 版本。使用 OAuth 来授权请求。允许的值为 Disabled、1.0 和 2.0。默认值为 Disabled。

输出属性

  • cookie:*: Cookie 随响应返回。
  • header:*: 响应返回的头文件。
  • http:allcookies: 响应中的所有 cookie,以单个字符串形式返回。
  • http:content: HTTP 响应的内容。
  • http:statuscode: 从请求返回的 HTTP 状态代码。
  • ssl:issuer: TLS/SSL 证书的颁发者。
  • ssl:subject: TLS/SSL 证书的主题。

示例

使用原始 POST 正文

使用表单数据作为正文