From 1290de53399722ca4345f47530b7e258ac9f881e Mon Sep 17 00:00:00 2001
From: liuleimin_hw <liuleimin1@huawei.com>
Date: Sat, 14 Jun 2025 19:31:35 +0800
Subject: [PATCH 1/2] HTTP C interface

Signed-off-by: liuleimin_hw <liuleimin1@huawei.com>
---
 .../network/netstack/net_http/net_http.h      | 144 +++++
 .../network/netstack/net_http/net_http_type.h | 565 ++++++++++++++++++
 2 files changed, 709 insertions(+)
 create mode 100644 zh-cn/native_sdk/network/netstack/net_http/net_http.h
 create mode 100644 zh-cn/native_sdk/network/netstack/net_http/net_http_type.h

diff --git a/zh-cn/native_sdk/network/netstack/net_http/net_http.h b/zh-cn/native_sdk/network/netstack/net_http/net_http.h
new file mode 100644
index 00000000..a2c20e7e
--- /dev/null
+++ b/zh-cn/native_sdk/network/netstack/net_http/net_http.h
@@ -0,0 +1,144 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License"),
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @addtogroup netstack
+ * @{
+ *
+ * @brief 为HTTP请求模块定义C接口。
+ *
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+
+/**
+ * @file net_http.h
+ * @brief 定义HTTP请求模块的接口。
+ *
+ * @library libnet_http.so
+ * @kit NetworkKit
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+
+#ifndef NET_HTTP_H
+#define NET_HTTP_H
+
+#include <stdint.h>
+#include <string.h>
+
+#include "net_http_type.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief 创建HTTP请求或者响应的头。
+ *
+ * @return Http_Headers* 返回HTTP请求或者响应的头，指向Http_Headers。
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+Http_Headers *OH_Http_CreateHeaders(void);
+
+/**
+ * @brief 销毁HTTP请求或者响应的头。
+ *
+ * @param headers HTTP请求或响应的头。
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+void OH_Http_DestroyHeaders(Http_Headers **headers);
+
+/**
+ * @brief 设置HTTP请求或者响应的头的键值对。
+ *
+ * @param headers 指向要设置的Http_Headers的指针。
+ * @param name 键值。
+ * @param value 值。
+ * @return uint32_t 0 - 成功。 401 - 参数错误。 2300027 - 内存不足。
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+uint32_t OH_Http_SetHeaderValue(struct Http_Headers *headers, const char *name, const char *value);
+
+/**
+ * @brief 通过键获取请求或响应头的值。
+ *
+ * @param headers 指向要获取值的Http_Headers的指针。
+ * @param name 键值。
+ * @return Http_HeaderValue* 指向获取的Http_HeaderValue的指针。
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+Http_HeaderValue *OH_Http_GetHeaderValue(Http_Headers *headers, const char *name);
+
+/**
+ * @brief 获取请求或响应头的所有键值对。
+ *
+ * @param headers 指向要获取值的Http_Headers的指针。
+ * @return Http_HeaderEntry* 指向获取的Http_HeaderEntry的指针
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+Http_HeaderEntry *OH_Http_GetHeaderEntries(Http_Headers *headers);
+
+/**
+ * @brief 销毁OH_Http_GetHeaderEntries中获取的所有键值对。
+ *
+ * @param headerEntry 指向要销毁的Http_HeaderEntry的指针。
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+void OH_Http_DestroyHeaderEntries(Http_HeaderEntry **headerEntry);
+
+/**
+ * @brief 创建HTTP请求。
+ *
+ * @param url 请求URL。
+ * @return 返回创建的请求，指向Http_Request的指针
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+Http_Request *OH_Http_CreateRequest(const char *url);
+ 
+/**
+ * @brief 发起HTTP请求。
+ *
+ * @param request 发送的请求，指向Http_Request的指针。
+ * @param callback 请求的响应，指向Http_ResponseCallback。
+ * @param handler 监听不同HTTP事件的回调函数。
+ * @return 0 if success; non-0 otherwise. For details about error codes, see {@link Http_ErrCode}.
+ * @permission ohos.permission.INTERNET
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+int OH_Http_Request(Http_Request *request, Http_ResponseCallback callback, Http_EventsHandler handler);
+ 
+/**
+ * @brief 销毁HTTP请求。
+ *
+ * @param request 要销毁的请求，指向Http_Request的指针。
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+void OH_Http_Destroy(struct Http_Request **request);
+#ifdef __cplusplus
+}
+#endif
+#endif // NET_HTTP_H
+
+/** @} */
\ No newline at end of file
diff --git a/zh-cn/native_sdk/network/netstack/net_http/net_http_type.h b/zh-cn/native_sdk/network/netstack/net_http/net_http_type.h
new file mode 100644
index 00000000..a0debea4
--- /dev/null
+++ b/zh-cn/native_sdk/network/netstack/net_http/net_http_type.h
@@ -0,0 +1,565 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License"),
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @addtogroup netstack
+ * @{
+ *
+ * @brief 为HTTP请求模块定义C接口。
+ *
+ * @since 20
+ */
+
+/**
+ * @file net_http_type.h
+ * @brief 定义HTTP请求模块的C接口需要的数据结构。
+ *
+ * @library libnet_http.so
+ * @kit NetworkKit
+ * @syscap SystemCapability.Communication.NetStack
+ * @since 20
+ */
+
+#ifndef NET_HTTP_TYPE_H
+#define NET_HTTP_TYPE_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define OHOS_HTTP_MAX_PATH_LEN 128
+#define OHOS_HTTP_MAX_STR_LEN 256
+#define OHOS_HTTP_DNS_SERVER_NUM_MAX 3
+
+/**
+ * @brief 定义HTTP请求的错误码。
+ *
+ * @since 20
+ */
+typedef enum Http_ErrCode {
+  /** 请求成功。 */
+  OH_HTTP_RESULT_OK = 0,
+  /** @brief 参数错误。 */
+  OH_HTTP_PARAMETER_ERROR = 401,
+  /** @brief 权限校验失败。 */
+  OH_HTTP_PERMISSION_DENIED = 201,
+  /** @brief 基础错误码偏移。 */
+  OH_HTTP_NETSTACK_E_BASE = 2300000,
+  /** @brief 不支持的协议。 */
+  OH_HTTP_UNSUPPORTED_PROTOCOL = (OH_HTTP_NETSTACK_E_BASE + 1),
+  /** @brief URL格式错误。 */
+  OH_HTTP_INVALID_URL = (OH_HTTP_NETSTACK_E_BASE + 3),
+  /** @brief 代理服务器域名解析失败。 */
+  OH_HTTP_RESOLVE_PROXY_FAILED = (OH_HTTP_NETSTACK_E_BASE + 5),
+  /** @brief 域名解析失败。 */
+  OH_HTTP_RESOLVE_HOST_FAILED = (OH_HTTP_NETSTACK_E_BASE + 6),
+  /** @brief 无法连接到服务器。 */
+  OH_HTTP_CONNECT_SERVER_FAILED = (OH_HTTP_NETSTACK_E_BASE + 7),
+  /** @brief 服务器返回非法数据。 */
+  OH_HTTP_INVALID_SERVER_RESPONSE = (OH_HTTP_NETSTACK_E_BASE + 8),
+  /** @brief 拒绝访问远程资源。 */
+  OH_HTTP_ACCESS_REMOTE_DENIED = (OH_HTTP_NETSTACK_E_BASE + 9),
+  /** @brief HTTP2 框架层出现错误。 */
+  OH_HTTP_HTTP2_FRAMING_ERROR = (OH_HTTP_NETSTACK_E_BASE + 16),
+  /** @brief 传输了部分文件。 */
+  OH_HTTP_TRANSFER_PARTIAL_FILE = (OH_HTTP_NETSTACK_E_BASE + 18),
+  /** @brief 无法将接收到的数据写入磁盘或应用程序。 */
+  OH_HTTP_WRITE_DATA_FAILED = (OH_HTTP_NETSTACK_E_BASE + 23),
+  /** @brief 上传失败 */
+  OH_HTTP_UPLOAD_FAILED = (OH_HTTP_NETSTACK_E_BASE + 25),
+  /** @brief 无法打开或读取文件或应用程序中的本地数据。 */
+  OH_HTTP_OPEN_LOCAL_DATA_FAILED = (OH_HTTP_NETSTACK_E_BASE + 26),
+  /** @brief 内存不足 */
+  OH_HTTP_OUT_OF_MEMORY = (OH_HTTP_NETSTACK_E_BASE + 27),
+  /** @brief 操作超时 */
+  OH_HTTP_OPERATION_TIMEOUT = (OH_HTTP_NETSTACK_E_BASE + 28),
+  /** @brief 重定向次数已达到允许的最大值。 */
+  OH_HTTP_TOO_MANY_REDIRECTIONS = (OH_HTTP_NETSTACK_E_BASE + 47),
+  /** @brief 服务器没有返回任何内容（没有标头或数据）。 */
+  OH_HTTP_SERVER_RETURNED_NOTHING = (OH_HTTP_NETSTACK_E_BASE + 52),
+  /** @brief 发送数据失败。 */
+  OH_HTTP_SEND_DATA_FAILED = (OH_HTTP_NETSTACK_E_BASE + 55),
+  /** @brief 接收数据失败。 */
+  OH_HTTP_RECEIVE_DATA_FAILED = (OH_HTTP_NETSTACK_E_BASE + 56),
+  /** @brief 本地 SSL 证书错误。 */
+  OH_HTTP_SSL_CERTIFICATE_ERROR = (OH_HTTP_NETSTACK_E_BASE + 58),
+  /** @brief 指定的加密套件不可用。 */
+  OH_HTTP_SSL_CIPHER_USED_ERROR = (OH_HTTP_NETSTACK_E_BASE + 59),
+  /** @brief SSL 对等证书或 SSH 远程密钥无效。 */
+  OH_HTTP_INVALID_SSL_PEER_CERT = (OH_HTTP_NETSTACK_E_BASE + 60),
+  /** @brief HTTP 编码格式无效。 */
+  OH_HTTP_INVALID_ENCODING_FORMAT = (OH_HTTP_NETSTACK_E_BASE + 61),
+  /** @brief 超出最大文件大小。 */
+  OH_HTTP_FILE_TOO_LARGE = (OH_HTTP_NETSTACK_E_BASE + 63),
+  /** @brief 远端磁盘满。 */
+  OH_HTTP_REMOTE_DISK_FULL = (OH_HTTP_NETSTACK_E_BASE + 70),
+  /** @brief 远端文件已存在。 */
+  OH_HTTP_REMOTE_FILE_EXISTS = (OH_HTTP_NETSTACK_E_BASE + 73),
+  /** @brief SSL CA 证书不存在或无法访问。 */
+  OH_HTTP_SSL_CA_NOT_EXIST = (OH_HTTP_NETSTACK_E_BASE + 77),
+  /** @brief 远端文件未找到。 */
+  OH_HTTP_REMOTE_FILE_NOT_FOUND = (OH_HTTP_NETSTACK_E_BASE + 78),
+  /** @brief 身份验证错误。 */
+  OH_HTTP_AUTHENTICATION_ERROR = (OH_HTTP_NETSTACK_E_BASE + 94),
+  /** @brief 不允许访问该域。 */
+  OH_HTTP_ACCESS_DOMAIN_NOT_ALLOWED = (OH_HTTP_NETSTACK_E_BASE + 998),
+  /** @brief 未知错误。 */
+  OH_HTTP_UNKNOWN_ERROR = (OH_HTTP_NETSTACK_E_BASE + 999)
+} Http_ErrCode;
+
+/**
+ * @brief Defines http response code.
+ *
+ * @since 20
+ */
+typedef enum Http_ResponseCode {
+  /** @brief 请求成功。 */
+  OH_HTTP_OK = 200,
+  /** @brief 成功请求并创建新资源。 */
+  OH_HTTP_CREATED = 201,
+  /** @brief 请求已被接受但尚未完全处理。 */
+  OH_HTTP_ACCEPTED = 202,
+  /** @brief 请求成功。但是有未授权信息。 */
+  OH_HTTP_NOT_AUTHORITATIVE = 203,
+  /** @brief 服务器处理成功，但未返回内容。 */
+  OH_HTTP_NO_CONTENT = 204,
+  /** @brief 重置内容。 */
+  OH_HTTP_RESET = 205,
+  /** @brief 服务器成功处理了部分 GET 请求。 */
+  OH_HTTP_PARTIAL = 206,
+  /** @brief 多种选择。 */
+  OH_HTTP_MULT_CHOICE = 300,
+  /** @brief 请求的资源已永久移动到新的 URI，返回信息将包含新的 URI。浏览器将自动重定向到新的 URI。 */
+  OH_HTTP_MOVED_PERM = 301,
+  /** @brief 临时重定向。 */
+  OH_HTTP_MOVED_TEMP = 302,
+  /** @brief 查看其他地址。请求的资源已移动到新的URL，客户端应使用GET方法访问该URL。 */
+  OH_HTTP_SEE_OTHER = 303,
+  /** @brief 请求的资源没有修改。 */
+  OH_HTTP_NOT_MODIFIED = 304,
+  /** @brief 请求资源需要使用代理访问。 */
+  OH_HTTP_USE_PROXY = 305,
+  /** @brief 服务器无法理解客户端请求的语法错误错误。 */
+  OH_HTTP_BAD_REQUEST = 400,
+  /** @brief 请求用户身份验证。 */
+  OH_HTTP_UNAUTHORIZED = 401,
+  /** @brief 保留以供将来使用。 */
+  OH_HTTP_PAYMENT_REQUIRED = 402,
+  /** @brief 服务器理解来自请求客户端的请求，但拒绝执行它。 */
+  OH_HTTP_FORBIDDEN = 403,
+  /** @brief 服务器无法根据客户端的请求找到资源。 */
+  OH_HTTP_NOT_FOUND = 404,
+  /** @brief 客户端请求中的方法被禁止。 */
+  OH_HTTP_BAD_METHOD = 405,
+  /** @brief 服务器无法根据客户端请求的内容特征完成请求。 */
+  OH_HTTP_NOT_ACCEPTABLE = 406,
+  /** @brief 请求验证代理人的身份。 */
+  OH_HTTP_PROXY_AUTH = 407,
+  /** @brief 请求耗时太长，超时。 */
+  OH_HTTP_CLIENT_TIMEOUT = 408,
+  /** @brief 服务器在完成客户端的 PUT 请求时可能返回此代码，因为服务器在处理请求时发生冲突。 */
+  OH_HTTP_CONFLICT = 409,
+  /** @brief 客户端请求的资源不再存在。 */
+  OH_HTTP_GONE = 410,
+  /** @brief 服务器无法处理客户端发送的不带Content Length的请求信息。 */
+  OH_HTTP_LENGTH_REQUIRED = 411,
+  /** @brief 向客户端请求信息的前提条件不正确。 */
+  OH_HTTP_PRECON_FAILED = 412,
+  /** @brief 请求被拒绝，因为请求的实体太大，服务器无法处理。 */
+  OH_HTTP_ENTITY_TOO_LARGE = 413,
+  /** @brief 请求的URI超过了服务器能够解析的长度，服务器无法处理。 */
+  OH_HTTP_REQ_TOO_LONG = 414,
+  /** @brief 服务器无法处理请求的格式。 */
+  OH_HTTP_UNSUPPORTED_TYPE = 415,
+  /** @brief 请求的范围无法满足。 */
+  OH_HTTP_RANGE_NOT_SATISFIABLE = 416,
+  /** @brief 内部服务器错误，无法完成请求。*/
+  OH_HTTP_INTERNAL_ERROR = 500,
+  /** @brief 服务器不支持请求的功能，无法完成请求。 */
+  OH_HTTP_NOT_IMPLEMENTED = 501,
+  /** @brief 充当网关或代理的服务器从远程服务器收到无效请求。 */
+  OH_HTTP_BAD_GATEWAY = 502,
+  /** @brief 由于超载或系统维护，服务器暂时无法处理客户端请求。 */
+  OH_HTTP_UNAVAILABLE = 503,
+  /** @brief 作为网关的服务器没有及时从远程服务器获取请求。 */
+  OH_HTTP_GATEWAY_TIMEOUT = 504,
+  /** @brief 服务器请求的HTTP协议版本。 */
+  OH_HTTP_VERSION = 505
+} Http_ResponseCode;
+
+/**
+ * @brief HTTP缓存结构体。
+ *
+ * @since 20
+ */
+typedef struct Http_Buffer {
+  /** 缓存区数据。 */
+  const char *buffer;
+  /** 缓存区长度。 */
+  uint32_t length;
+} Http_Buffer;
+
+/**
+ * @brief Defines the address Family.
+ *
+ * @since 20
+ */
+typedef enum Http_AddressFamilyType {
+  /** Default, The system automatically selects the IPv4 or IPv6 address of the domain name. */
+  HTTP_ADDRESS_FAMILY_DEFAULT = 0,
+  /** IPv4, Selects the IPv4 address of the domain name. */
+  HTTP_ADDRESS_FAMILY_ONLY_V4 = 1,
+  /** IPv6, Selects the IPv4 address of the domain name. */
+  HTTP_ADDRESS_FAMILY_ONLY_V6 = 2
+} Http_AddressFamilyType;
+ 
+/**
+ * @brief HTTP请求GET方法。
+ *
+ * @since 20
+ */
+#define NET_HTTP_METHOD_GET "GET"
+
+/**
+ * @brief HTTP请求HEAD方法。
+ *
+ * @since 20
+ */
+#define NET_HTTPMETHOD_HEAD "HEAD"
+
+/**
+ * @brief HTTP请求OPTIONS方法。
+ *
+ * @since 20
+ */
+#define NET_HTTPMETHOD_OPTIONS "OPTIONS"
+
+/**
+ * @brief HTTP请求TRACE方法。
+ *
+ * @since 20
+ */
+#define NET_HTTPMETHOD_TRACE "TRACE"
+/**
+ * @brief HTTP请求DELETE方法。
+ * @since 20
+ */
+#define NET_HTTPMETHOD_DELETE "DELETE"
+
+/**
+ * @brief HTTP请求POST方法。
+ *
+ * @since 20
+ */
+#define NET_HTTP_METHOD_POST "POST"
+
+/**
+ * @brief HTTP请求PUT方法。
+ *
+ * @since 20
+ */
+#define NET_HTTP_METHOD_PUT "PUT"
+
+/**
+ * @brief HTTP请求CONNECT方法。
+ *
+ * @since 20
+ */
+#define NET_HTTP_METHOD_PATCH "CONNECT"
+
+/**
+ * @brief HTTP协议版本号枚举定义。
+ *
+ * @since 20
+ */
+typedef enum Http_HttpProtocol {
+  /** 跟随crul的协议版本选择。 */
+  OH_HTTP_NONE = 0,
+  /** HTTP 1.1 版本。 */
+  OH_HTTP1_1,
+  /** HTTP 2 版本。 */
+  OH_HTTP2,
+  /** HTTP 3 版本。 */
+  OH_HTTP3
+} Http_HttpProtocol;
+
+/**
+ * @brief 证书类型枚举。
+ *
+ * @since 20
+ */
+typedef enum Http_CertType {
+  /** PEM证书类型。 */
+  OH_HTTP_PEM = 0,
+  /** DER证书类型。 */
+  OH_HTTP_DER = 1,
+  /** P12证书类型。 */
+  OH_HTTP_P12 = 2
+} Http_CertType;
+
+/**
+ * @brief HTTP请求或者是响应中的标头。
+ *
+ * @since 20
+ */
+typedef struct Http_Headers Http_Headers;
+
+/**
+ * @brief 请求或者响应的标头映射的值类型。
+ *
+ * @since 20
+ */
+typedef struct Http_HeaderValue {
+  /** 标头键值对的值。 */
+  char *value;
+  /** 链式存储。指向下一个Http_HeaderValue。 */
+  struct Http_HeaderValue *next;
+} Http_HeaderValue;
+
+/**
+ * @brief 请求或者响应的标头的所有键值对。
+ *
+ * @since 20
+ */
+typedef struct Http_HeaderEntry {
+  /** 键。 */
+  char *key;
+  /** 值。 */
+  Http_HeaderValue *value;
+  /** 链式存储。指向下一个Http_HeaderEntry */
+  struct Http_HeaderEntry *next;
+} Http_HeaderEntry;
+
+/**
+ * @brief Client certificate which is sent to the remote server, the the remote server will use it to verify the
+ * client's identification.
+ *
+ * @since 20
+ */
+typedef struct Http_ClientCert {
+  /** 证书路径。 */
+  char *certPath;
+  /** 证书类型，默认是PEM。 */
+  Http_CertType type;
+  /** 证书密钥的路径。 */
+  char *keyPath;
+  /** 证书密钥的密码。 */
+  char *keyPassword;
+} Http_ClientCert;
+
+/**
+ * @brief 代理配置类型枚举定义。
+ *
+ * @since 20
+ */
+typedef enum Http_ProxyType {
+  /** 不使用代理。 */
+  HTTP_PROXY_NOT_USE,
+  /** 使用系统代理。 */
+  HTTP_PROXY_SYSTEM,
+  /** 使用用户自定义代理。 */
+  HTTP_PROXY_CUSTOM
+} Http_ProxyType;
+
+/**
+ * @brief 用户自定义代理配置。
+ *
+ * @since 20
+ */
+typedef struct Http_CustomProxy {
+  /** 代理服务器主机名。 */
+  const char *host;
+  /** 主机端口。取值范围[0, 65535]。 */
+  int32_t port;
+  /** 不使用代理的主机名列表，主机名支持域名、IP地址以及通配符形式。 */
+  const char *exclusionLists;
+} Http_CustomProxy;
+
+/**
+ * @brief 代理配置结构体。
+ *
+ * @since 20
+ */
+typedef struct Http_Proxy {
+  /** 代理配置类型。 */
+  Http_ProxyType proxyType;
+  /** 自定义代理配置信息。 */
+  Http_CustomProxy customProxy;
+} Http_Proxy;
+
+/**
+ * @brief HTTP响应时间信息。
+ *
+ * @since 20
+ */
+typedef struct Http_PerformanceTiming {
+  /** 从request请求到DNS解析完成的耗时。 */
+  double dnsTiming;
+  /** 从request请求到TCP连接完成的耗时。 */
+  double tcpTiming;
+  /** 从request请求到TLS连接完成的耗时。 */
+  double tlsTiming;
+  /** 从request请求到开始发送第一个字节的耗时。  */
+  double firstSendTiming;
+  /** 从request请求到接收到第一个字节的耗时。 */
+  double firstReceiveTiming;
+  /** 从request请求到完成请求的耗时。 */
+  double totalFinishTiming;
+  /** 从request请求到完成所有重定向步骤的耗时。 */
+  double redirectTiming;
+} Http_PerformanceTiming;
+
+/**
+ * @brief 定义HTTP请求配置的结构体。
+ *
+ * @since 20
+ */
+typedef struct Http_RequestOptions {
+  /** HTTP请求方法。 */
+  const char *method;
+  /** HTTP请求优先级。 */
+  uint32_t priority;
+  /** HTTP请求头，指向Http_Headers的指针。 */
+  Http_Headers *headers;
+  /** 读取超时时间。 */
+  uint32_t readTimeout;
+  /** 连接超时时间。 */
+  uint32_t connectTimeout;
+  /** 使用的协议。 */
+  Http_HttpProtocol httpProtocol;
+  /** 代理配置信息。 */
+  Http_Proxy *httpProxy;
+  /** 证书路径，如果设置了此参数，系统将使用用户指定路径的CA证书（开发者需保证该路径下CA证书的可访问性），否则将使用系统预设CA证书。 */
+  const char *caPath;
+  /** 用于设置下载起始位置，该参数只能用于GET方法，不要用于其他。 */
+  int64_t resumeFrom;
+  /** 用于设置下载结束位置，该参数只能用于GET方法，不要用于其他。 */
+  int64_t resumeTo;
+  /** 传输客户端证书配置信息。 */
+  Http_ClientCert *clientCert;
+  /** 设置使用HTTPS协议的服务器进行DNS解析。 */
+  const char *dnsOverHttps;
+  /** 响应消息的最大字节限制。 */
+  uint32_t maxLimit;
+  /** 支持解析目标域名时限定地址类型。 */
+  Http_AddressFamilyType addressFamily;
+} Http_RequestOptions;
+
+/**
+ * @brief 定义HTTP响应的结构体。
+ *
+ * @since 20
+ */
+typedef struct Http_Response {
+  /** HTTP请求响应的数据，指向Http_Buffer的指针。 */
+  Http_Buffer body;
+  /** HTTP请求响应码，具体信息可参考Http_ResponseCode。 */
+  Http_ResponseCode responseCode;
+  /** HTTP响应的头，指向Http_Headers的指针。 */
+  Http_Headers *headers;
+  /** HTTP响应Cookies。 */
+  char *cookies;
+  /** HTTP响应时间信息，指向Http_PerformanceTiming的指针。 */
+  Http_PerformanceTiming *performanceTiming;
+  /**
+   * @brief 销毁HTTP响应的回调函数
+   *
+   * @param response 要销毁的HTTP响应，指向Http_Response的指针。
+   * @since 20
+   */
+  void (*destroyResponse)(struct Http_Response **response);
+} Http_Response;
+
+/**
+ * @brief HTTP请求结构体。
+ *
+ * @since 20
+ */
+typedef struct Http_Request {
+  /** HTTP请求的Id。 */
+  uint32_t requestId;
+  /** HTTP请求的URL。 */
+  char *url;
+  /** HTTP请求配置，指向Http_RequestOptions的指针。 */
+  Http_RequestOptions *options;
+} Http_Request;
+
+/**
+ * @brief 接收到HTTP响应的回调函数
+ *
+ * @param response HTTP影响结构体，指向Http_Response的指针。
+ * @param errCode 响应码。
+ * @since 20
+ */
+typedef void (*Http_ResponseCallback)(struct Http_Response *response, uint32_t errCode);
+
+/**
+ * @brief 接收到数据的回调。
+ *
+ * @param data 响应体。
+ * @return size_t 响应体的长度。
+ * @since 20
+ */
+typedef size_t (*Http_OnDataReceiveCallback)(const char *data);
+
+/**
+ * @brief 请求/响应数据传输过程中调用的回调函数。
+ *
+ * @param totalSize 数据总大小。
+ * @param transferredSize 已传输的数据大小。
+ * @since 20
+ */
+typedef void (*Http_OnProgressCallback)(uint64_t totalSize, uint64_t transferredSize);
+
+/**
+ * @brief 收到HTTP响应头的回调函数。
+ *
+ * @param headers 接收到的请求头，指向Http_Headers的指针。
+ * @since 20
+ */
+typedef void (*Http_OnHeaderReceiveCallback)(Http_Headers *headers);
+
+/**
+ * @brief 请求的DataEnd或Cancel事件回调的回调函数。
+ *
+ * @since 20
+ */
+typedef void (*Http_OnVoidCallback)(void);
+
+/**
+ * @brief 监听不同HTTP事件的回调函数。
+ *
+ * @since 20
+ */
+typedef struct Http_EventsHandler {
+  /** 收到响应体时的回调函数。 */
+  Http_OnDataReceiveCallback onDataReceive;
+  /** 上传时调用的回调函数。 */
+  Http_OnProgressCallback onUploadProgress;
+  /** 下载时调用的回调函数。 */
+  Http_OnProgressCallback onDownloadProgress;
+  /** 收到header时的回调函数 */
+  Http_OnHeaderReceiveCallback onHeadersReceive;
+  /** 传输结束时的回调函数。 */
+  Http_OnVoidCallback onDataEnd;
+  /** 请求被取消时的回调函数。 */
+  Http_OnVoidCallback onCanceled;
+} Http_EventsHandler;
+#ifdef __cplusplus
+}
+#endif
+#endif // NET_HTTP_TYPE_H
+
+/** @} */
\ No newline at end of file
-- 
Gitee


From c87740e482c51c5569a0a285a2a868c94f5f1cf2 Mon Sep 17 00:00:00 2001
From: liuleimin_hw <liuleimin1@huawei.com>
Date: Sat, 14 Jun 2025 19:59:28 +0800
Subject: [PATCH 2/2] HTTP C interface 2

Signed-off-by: liuleimin_hw <liuleimin1@huawei.com>
---
 zh-cn/native_sdk/network/netstack/net_http/net_http_type.h | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/zh-cn/native_sdk/network/netstack/net_http/net_http_type.h b/zh-cn/native_sdk/network/netstack/net_http/net_http_type.h
index a0debea4..449f2cdb 100644
--- a/zh-cn/native_sdk/network/netstack/net_http/net_http_type.h
+++ b/zh-cn/native_sdk/network/netstack/net_http/net_http_type.h
@@ -343,8 +343,7 @@ typedef struct Http_HeaderEntry {
 } Http_HeaderEntry;
 
 /**
- * @brief Client certificate which is sent to the remote server, the the remote server will use it to verify the
- * client's identification.
+ * @brief 客户端证书结构体。
  *
  * @since 20
  */
-- 
Gitee