net_http.h

Go to the documentation of this file.

/*
 * Copyright (C) 2026 Kamil Lulko <kamil.lulko@gmail.com>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * This file is part of oveRTOS.
 */
 
#ifndef OVE_NET_HTTP_H
#define OVE_NET_HTTP_H
 
#include "ove/types.h"
#include "ove/net.h"
#include "ove_config.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum {
    OVE_HTTP_GET = 0,    
    OVE_HTTP_POST = 1,   
    OVE_HTTP_PUT = 2,    
    OVE_HTTP_DELETE = 3, 
    OVE_HTTP_PATCH = 4,  
} ove_http_method_t;
 
typedef struct {
    const char *name;  
    const char *value; 
} ove_http_header_t;
 
typedef struct {
    int status;     
    char *body;     
    size_t body_len;    
    char *headers;      
    size_t headers_len; 
} ove_http_response_t;
 
#include "ove/storage.h"
 
#ifdef CONFIG_OVE_NET_HTTP
 
int ove_http_client_init(ove_http_client_t *client, ove_http_client_storage_t *storage);
 
void ove_http_client_deinit(ove_http_client_t client);
 
int ove_http_get(ove_http_client_t client, const char *url, ove_http_response_t *resp);
 
int ove_http_post(ove_http_client_t client, const char *url, const char *content_type,
          const void *body, size_t body_len, ove_http_response_t *resp);
 
int ove_http_request(ove_http_client_t client, ove_http_method_t method, const char *url,
             const char *content_type, const void *body, size_t body_len,
             ove_http_response_t *resp);
 
int ove_http_request_ex(ove_http_client_t client, ove_http_method_t method, const char *url,
            const char *content_type, const void *body, size_t body_len,
            const ove_http_header_t *headers, size_t header_count,
            ove_http_response_t *resp);
 
void ove_http_response_free(ove_http_response_t *resp);
 
#ifdef OVE_HEAP_NET_HTTP
int ove_http_client_create(ove_http_client_t *client);
 
void ove_http_client_destroy(ove_http_client_t client);
#endif /* OVE_HEAP_NET_HTTP */
 
#else /* !CONFIG_OVE_NET_HTTP */
 
#ifndef CONFIG_OVE_NET_HTTP
typedef struct {
    uint8_t _unused;
} ove_http_client_storage_t;
#endif
 
static inline int ove_http_client_init(ove_http_client_t *client,
                       ove_http_client_storage_t *storage)
{
    (void)client;
    (void)storage;
    return OVE_ERR_NOT_SUPPORTED;
}
static inline void ove_http_client_deinit(ove_http_client_t client)
{
    (void)client;
}
static inline int ove_http_get(ove_http_client_t client, const char *url, ove_http_response_t *resp)
{
    (void)client;
    (void)url;
    (void)resp;
    return OVE_ERR_NOT_SUPPORTED;
}
static inline int ove_http_post(ove_http_client_t client, const char *url, const char *content_type,
                const void *body, size_t body_len, ove_http_response_t *resp)
{
    (void)client;
    (void)url;
    (void)content_type;
    (void)body;
    (void)body_len;
    (void)resp;
    return OVE_ERR_NOT_SUPPORTED;
}
static inline int ove_http_request(ove_http_client_t client, ove_http_method_t method,
                   const char *url, const char *content_type, const void *body,
                   size_t body_len, ove_http_response_t *resp)
{
    (void)client;
    (void)method;
    (void)url;
    (void)content_type;
    (void)body;
    (void)body_len;
    (void)resp;
    return OVE_ERR_NOT_SUPPORTED;
}
static inline int ove_http_request_ex(ove_http_client_t client, ove_http_method_t method,
                      const char *url, const char *content_type, const void *body,
                      size_t body_len, const ove_http_header_t *headers,
                      size_t header_count, ove_http_response_t *resp)
{
    (void)client;
    (void)method;
    (void)url;
    (void)content_type;
    (void)body;
    (void)body_len;
    (void)headers;
    (void)header_count;
    (void)resp;
    return OVE_ERR_NOT_SUPPORTED;
}
static inline void ove_http_response_free(ove_http_response_t *resp)
{
    (void)resp;
}
#endif /* CONFIG_OVE_NET_HTTP */
 
#ifdef __cplusplus
}
#endif
 
#endif /* OVE_NET_HTTP_H */