summaryrefslogtreecommitdiff
path: root/include/tgbot/net/HttpClient.h
blob: 1f1b2a267e85395be2ab5db6dde9143b91274568 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
#ifndef TGBOT_HTTPCLIENT_H
#define TGBOT_HTTPCLIENT_H

#include "tgbot/net/Url.h"
#include "tgbot/net/HttpReqArg.h"

#include <string>
#include <vector>
#include <cstdint>

namespace TgBot {

/**
 * @brief This class makes http requests.
 *
 * @ingroup net
 */
class TGBOT_API HttpClient {

public:
    virtual ~HttpClient() = default;

    /**
     * @brief Sends a request to the url.
     *
     * If there's no args specified, a GET request will be sent, otherwise a POST request will be sent.
     * If at least 1 arg is marked as file, the content type of a request will be multipart/form-data, otherwise it will be application/x-www-form-urlencoded.
     */
    virtual std::string makeRequest(const Url& url, const std::vector<HttpReqArg>& args) const = 0;

    std::int32_t _timeout = 25;

    /**
      * @brief Get the maximum number of makeRequest() retries before giving up and throwing an exception.
      */
    virtual int getRequestMaxRetries() const {
        return requestMaxRetries;
    }

    /**
      * @brief Get the makeRequest() backoff duration between retries, in seconds.
      */
    virtual int getRequestBackoff() const {
        return requestBackoff;
    }

private:
    int requestMaxRetries = 3;
    int requestBackoff = 1;
};

}


#endif //TGBOT_HTTPCLIENT_H