vorteil/request

Request 镜像文档

镜像概述

vorteil/request是一个用于执行基本HTTP/HTTPS请求的Docker镜像，基于Go程序实现。该镜像通过JSON格式的输入配置请求参数，能够发送各类HTTP请求并返回结构化的响应结果，适用于需要程序化处理HTTP通信的场景。

核心功能与特性

• 支持多种HTTP方法（GET、POST、PUT等）
• 可配置请求URL、请求体、请求头和查询参数
• 集成基本认证功能（用户名/密码验证）
• 提供TLS证书验证控制（支持跳过不安全证书验证）
• 自动解析JSON响应，非JSON响应以Base64编码返回
• 结构化输出包含状态码、响应头和响应内容

使用场景

• 自动化工作流中的HTTP请求发送（如Direktiv平台集成）
• API接口测试与验证
• 服务间数据同步与通信
• 定时任务中的HTTP请求执行
• 需要程序化配置HTTP请求参数的场景

使用方法

Direktiv工作流集成示例

在Direktiv工作流中使用该镜像的配置示例：

yaml
id: request
functions:
- id: myrequest
  image: vorteil/request:v6
description: "发送GET请求" 
states:
- id: hello
  type: action
  action: 
    function: myrequest
    input: 
      method: "GET"
      url: "https://jsonplaceholder.typicode.com/posts"

输入参数说明

请求输入为JSON格式，支持以下字段：

yaml
input:
  method: "GET"        # HTTP方法，必填，如GET、POST、PUT等
  url: "https://vorteil.io"  # 请求URL，必填
  body:                # 请求体，可选，JSON对象格式
    hello: "world"
  headers:             # 请求头，可选，键值对格式
    "Content-Type": "application/json" 
  params:              # 查询参数，可选，键值对格式
    Hello: "world"
  username: "test"     # 基本认证用户名，可选
  password: "test2"    # 基本认证密码，可选
  insecureSkipVerify: false  # 是否跳过TLS证书验证，可选，默认false

注意：method和url为必填字段，其他为可选配置。

输出格式

JSON响应输出

当请求返回JSON格式响应时，输出包含解析后的JSON对象：

json
{
    "return": {
        "body": {
            "hello": "world"
        },
        "headers":{
            "Age": 0
        },
        "status-code": 200,
        "status": "200 OK"
    }
}

非JSON响应输出

当请求返回非JSON格式响应时，响应体以Base64编码形式返回：

json
{
    "return": {
        "data": "PGh0bWw+PGJvZHk+SGVsbG8gV29ybGQhPC9ib2R5PjwvaHRtbA==",
        "headers":{
            "Age": 0
        },
        "status-code": 200,
        "status": "200 OK"
    }
}

错误处理

请求过程中发生错误时，返回以下格式的错误信息：

json
{
    "errorCode": "com.%s.error",
    "errorMsg": "Something went wrong"
}

注意：%s将替换为错误发生的具体位置标识，用于定位问题。