90 lines
2.5 KiB
C
90 lines
2.5 KiB
C
#pragma once
|
|
|
|
#include "ipfs/core/ipfs_node.h"
|
|
|
|
/***
|
|
* A name/value pair of http parameters
|
|
*/
|
|
struct HttpParam {
|
|
char* name; // the name of the parameter
|
|
char* value; // the value of the parameter
|
|
};
|
|
|
|
/**
|
|
* A struct to help with incoming http requests
|
|
*/
|
|
struct HttpRequest {
|
|
char* command; // the command
|
|
char* sub_command; // the sub command
|
|
struct Libp2pVector* params; // a collection of HttpParam structs
|
|
struct Libp2pVector* arguments; // a collection of chars that are arguments
|
|
};
|
|
|
|
/***
|
|
* A struct to hold the response to be sent via http
|
|
*/
|
|
struct HttpResponse {
|
|
char* content_type; // a const char, not dynamically allocated
|
|
uint8_t* bytes; // dynamically allocated
|
|
size_t bytes_size;
|
|
};
|
|
|
|
/***
|
|
* Build a new HttpRequest
|
|
* @returns the newly allocated HttpRequest struct
|
|
*/
|
|
struct HttpRequest* ipfs_core_http_request_new();
|
|
|
|
/***
|
|
* Clean up resources of a HttpRequest struct
|
|
* @param request the struct to destroy
|
|
*/
|
|
void ipfs_core_http_request_free(struct HttpRequest* request);
|
|
|
|
struct HttpResponse* ipfs_core_http_response_new();
|
|
|
|
void ipfs_core_http_response_free(struct HttpResponse* response);
|
|
|
|
/***
|
|
* Build a new HttpParam
|
|
* @returns a newly allocated HttpParam struct
|
|
*/
|
|
struct HttpParam* ipfs_core_http_param_new();
|
|
|
|
/***
|
|
* Clean up resources allocated by a HttpParam struct
|
|
* @param param the struct to destroy
|
|
*/
|
|
void ipfs_core_http_param_free(struct HttpParam* param);
|
|
|
|
/***
|
|
* Process the parameters passed in from an http request
|
|
* @param local_node the context
|
|
* @param request the request
|
|
* @param response the response
|
|
* @returns true(1) on success, false(0) otherwise.
|
|
*/
|
|
int ipfs_core_http_request_process(struct IpfsNode* local_node, struct HttpRequest* request, struct HttpResponse** response);
|
|
|
|
/**
|
|
* Do an HTTP Get to the local API
|
|
* @param local_node the context
|
|
* @param request the request
|
|
* @param result the results
|
|
* @param result_size the size of the results
|
|
* @returns true(1) on success, false(0) on error
|
|
*/
|
|
int ipfs_core_http_request_get(struct IpfsNode* local_node, struct HttpRequest* request, char** result, size_t* result_size);
|
|
|
|
/**
|
|
* Do an HTTP Post to the local API
|
|
* @param local_node the context
|
|
* @param request the request
|
|
* @param result the results
|
|
* @param result_size the size of the results
|
|
* @param data the array with post data
|
|
* @param data_size the data length
|
|
* @returns true(1) on success, false(0) on error
|
|
*/
|
|
int ipfs_core_http_request_post(struct IpfsNode* local_node, struct HttpRequest* request, char** result, size_t* result_size, char *data, size_t data_size);
|