HTTP高级请求 - HttpRequestEx

函数简介

高级HTTP请求，支持自定义Method、请求头（含Cookie）、请求体。

接口名称

HttpRequestEx

DLL调用

const char* HttpRequestEx(int64_t instance, const char* method, const char* url, const char* headers, const char* body, const char* content_type, int32_t* status_code)

参数说明

参数名类型说明
instanceint64_tOLAPlug对象的指针
methodstring方法，如"GET"/"POST"/"PUT"/"DELETE"，大小写不敏感
urlstring完整URL
headersstring自定义请求头，多行字符串，每行"Name: Value"，可为空
bodystring请求体，GET可传空
content_typestring如"application/json"，可为空
status_codeint32_t*输出HTTP状态码，可为NULL

示例

// GET请求带自定义请求头
int32_t statusCode = 0;
const char* headers = 
    "User-Agent: MyApp/1.0\r\n"
    "Accept: application/json\r\n"
    "Authorization: Bearer token123\r\n";

const char* response = HttpRequestEx(instance,
    "GET",
    "https://api.example.com/data",
    headers,
    "",
    "",
    &statusCode);

printf("状态码：%d\n", statusCode);
if (response != NULL) {
    printf("响应：%s\n", response);
    FreeStringPtr(instance, response);
}

// POST请求带Cookie
const char* postHeaders = 
    "Cookie: session=abc123; user=admin\r\n"
    "User-Agent: MyApp/1.0\r\n";

const char* jsonBody = "{\"name\":\"test\"}";
const char* postResponse = HttpRequestEx(instance,
    "POST",
    "https://api.example.com/create",
    postHeaders,
    jsonBody,
    "application/json",
    &statusCode);

if (postResponse != NULL) {
    FreeStringPtr(instance, postResponse);
}

// PUT请求
const char* putResponse = HttpRequestEx(instance,
    "PUT",
    "https://api.example.com/users/123",
    "",
    "{\"age\":26}",
    "application/json",
    NULL);

if (putResponse != NULL) {
    FreeStringPtr(instance, putResponse);
}

// DELETE请求
const char* deleteResponse = HttpRequestEx(instance,
    "DELETE",
    "https://api.example.com/users/123",
    "",
    "",
    "",
    &statusCode);

if (deleteResponse != NULL) {
    FreeStringPtr(instance, deleteResponse);
}

返回值

返回值类型说明
string响应体字符串指针，失败返回NULL，需调用FreeStringPtr释放

注意事项

  • 返回的字符串需要调用 FreeStringPtr 释放内存
  • headers格式：每行"Name: Value"，以"\r\n"分隔
  • 支持的HTTP方法：GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS等
  • status_code可以为NULL，如果不需要获取状态码
  • 常见HTTP状态码：
    • 200 - 成功
    • 201 - 创建成功
    • 400 - 请求错误
    • 401 - 未授权
    • 403 - 禁止访问
    • 404 - 未找到
    • 500 - 服务器错误
Last Updated: