D++ (DPP)  10.0.30
C++ Discord API Bot Library
dpp::http_request Class Reference

A HTTP request. More...

#include "queues.h"

Collaboration diagram for dpp::http_request:

Public Member Functions

 http_request (const std::string &_endpoint, const std::string &_parameters, http_completion_event completion, const std::string &_postdata="", http_method method=m_get, const std::string &audit_reason="", const std::string &filename="", const std::string &filecontent="", const std::string &filemimetype="", const std::string &http_protocol="1.1")
 Constructor. More...
 
 http_request (const std::string &_endpoint, const std::string &_parameters, http_completion_event completion, const std::string &_postdata="", http_method method=m_get, const std::string &audit_reason="", const std::vector< std::string > &filename={}, const std::vector< std::string > &filecontent={}, const std::vector< std::string > &filemimetypes={}, const std::string &http_protocol="1.1")
 Constructor. More...
 
 http_request (const std::string &_url, http_completion_event completion, http_method method=m_get, const std::string &_postdata="", const std::string &_mimetype="text/plain", const std::multimap< std::string, std::string > &_headers={}, const std::string &http_protocol="1.1")
 Constructor. More...
 
 ~http_request ()
 Destroy the http request object. More...
 
void complete (const http_request_completion_t &c)
 Call the completion callback, if the request is complete. More...
 
bool is_completed ()
 Returns true if the request is complete. More...
 
http_request_completion_t run (class cluster *owner)
 Execute the HTTP request and mark the request complete. More...
 

Public Attributes

std::string endpoint
 Endpoint name e.g. More...
 
std::vector< std::string > file_content
 Upload file contents (binary). More...
 
std::vector< std::string > file_mimetypes
 Upload file mime types. More...
 
std::vector< std::string > file_name
 Upload file name (server side). More...
 
http_method method
 HTTP method for request. More...
 
std::string mimetype
 Request mime type. More...
 
std::string parameters
 Major and minor parameters. More...
 
std::string postdata
 Postdata for POST and PUT. More...
 
std::string protocol
 HTTP protocol. More...
 
std::string reason
 Audit log reason for Discord requests, if non-empty. More...
 
std::multimap< std::string, std::string > req_headers
 Request headers (non-discord requests only). More...
 
bool waiting
 Waiting for rate limit to expire. More...
 

Detailed Description

A HTTP request.

You should instantiate one of these objects via its constructor, and pass a pointer to it into an instance of request_queue. Although you can directly call the run() method of the object and it will make a HTTP call, be aware that if you do this, it will be a BLOCKING call (not asynchronous) and will not respect rate limits, as both of these functions are managed by the request_queue class.

Constructor & Destructor Documentation

◆ http_request() [1/3]

dpp::http_request::http_request ( const std::string &  _endpoint,
const std::string &  _parameters,
http_completion_event  completion,
const std::string &  _postdata = "",
http_method  method = m_get,
const std::string &  audit_reason = "",
const std::string &  filename = "",
const std::string &  filecontent = "",
const std::string &  filemimetype = "",
const std::string &  http_protocol = "1.1" 
)

Constructor.

When constructing one of these objects it should be passed to request_queue::post_request().

Parameters
_endpointThe API endpoint, e.g. /api/guilds
_parametersMajor and minor parameters for the endpoint e.g. a user id or guild id
completioncompletion event to call when done
_postdataData to send in POST and PUT requests
methodThe HTTP method to use from dpp::http_method
audit_reasonAudit log reason to send, empty to send none
filenameThe filename (server side) of any uploaded file
filecontentThe binary content of any uploaded file for the request
filemimetypeThe MIME type of any uploaded file for the request
http_protocolHTTP protocol

◆ http_request() [2/3]

dpp::http_request::http_request ( const std::string &  _endpoint,
const std::string &  _parameters,
http_completion_event  completion,
const std::string &  _postdata = "",
http_method  method = m_get,
const std::string &  audit_reason = "",
const std::vector< std::string > &  filename = {},
const std::vector< std::string > &  filecontent = {},
const std::vector< std::string > &  filemimetypes = {},
const std::string &  http_protocol = "1.1" 
)

Constructor.

When constructing one of these objects it should be passed to request_queue::post_request().

Parameters
_endpointThe API endpoint, e.g. /api/guilds
_parametersMajor and minor parameters for the endpoint e.g. a user id or guild id
completioncompletion event to call when done
_postdataData to send in POST and PUT requests
methodThe HTTP method to use from dpp::http_method
audit_reasonAudit log reason to send, empty to send none
filenameThe filename (server side) of any uploaded file
filecontentThe binary content of any uploaded file for the request
filemimetypesThe MIME type of any uploaded file for the request
http_protocolHTTP protocol

References dpp::http_request_completion_t::body, dpp::https_client::get_content(), dpp::https_client::get_headers(), dpp::https_client::get_status(), dpp::http_request_completion_t::headers, dpp::http_request_completion_t::status, and dpp::unicode_emoji::v.

Here is the call graph for this function:

◆ http_request() [3/3]

dpp::http_request::http_request ( const std::string &  _url,
http_completion_event  completion,
http_method  method = m_get,
const std::string &  _postdata = "",
const std::string &  _mimetype = "text/plain",
const std::multimap< std::string, std::string > &  _headers = {},
const std::string &  http_protocol = "1.1" 
)

Constructor.

When constructing one of these objects it should be passed to request_queue::post_request().

Parameters
_urlRaw HTTP url
completioncompletion event to call when done
methodThe HTTP method to use from dpp::http_method
_postdataData to send in POST and PUT requests
_mimetypePOST data mime type
_headersHTTP headers to send
http_protocolHTTP protocol

◆ ~http_request()

dpp::http_request::~http_request ( )
default

Destroy the http request object.

Member Function Documentation

◆ complete()

void dpp::http_request::complete ( const http_request_completion_t c)

Call the completion callback, if the request is complete.

Parameters
ccallback to call

References dpp::https_client::get_header(), and dpp::http_request_completion_t::ratelimit_retry_after.

Here is the call graph for this function:

◆ is_completed()

bool dpp::http_request::is_completed ( )

Returns true if the request is complete.

◆ run()

http_request_completion_t dpp::http_request::run ( class cluster owner)

Execute the HTTP request and mark the request complete.

Parameters
ownercreating cluster

NOTE: "#" is in this list, really # is client side only. This won't stop some moron from using it as part of an API endpoint...

Member Data Documentation

◆ endpoint

std::string dpp::http_request::endpoint

Endpoint name e.g.

/api/users.

◆ file_content

std::vector<std::string> dpp::http_request::file_content

Upload file contents (binary).

◆ file_mimetypes

std::vector<std::string> dpp::http_request::file_mimetypes

Upload file mime types.

application/octet-stream if unspecified.

◆ file_name

std::vector<std::string> dpp::http_request::file_name

Upload file name (server side).

◆ method

http_method dpp::http_request::method

HTTP method for request.

◆ mimetype

std::string dpp::http_request::mimetype

Request mime type.

◆ parameters

std::string dpp::http_request::parameters

Major and minor parameters.

◆ postdata

std::string dpp::http_request::postdata

Postdata for POST and PUT.

◆ protocol

std::string dpp::http_request::protocol

HTTP protocol.

◆ reason

std::string dpp::http_request::reason

Audit log reason for Discord requests, if non-empty.

◆ req_headers

std::multimap<std::string, std::string> dpp::http_request::req_headers

Request headers (non-discord requests only).

◆ waiting

bool dpp::http_request::waiting

Waiting for rate limit to expire.


The documentation for this class was generated from the following files: