Головна сторінка Огляд Довідка
Увійти
ded
/
cpp-httplib
дзеркало https://github.com/yhirose/cpp-httplib.git
1
0
Відгалуження 0
Файли Проблеми 0 Wiki
Дерево: cda9680cdc
Гілки Теги
cpp-httplib
/
docs
/
en
/
tour
/
02-basic-client
/
index.html

index.html 56 KB
Історія Запис

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512 
  1. <!DOCTYPE html>
    2. 

  2. <html lang="en" data-base-path="&#x2F;cpp-httplib">
    3. 

  3. <head>
    4. 

  4.   <meta charset="utf-8">
    5. 

  5.   <meta name="viewport" content="width=device-width, initial-scale=1">
    6. 

  6.   <title>Basic Client - cpp-httplib</title>
    7. 

  7.   <link rel="icon" type="image/svg+xml" href="&#x2F;cpp-httplib/favicon.svg">
    8. 

  8.   <link rel="stylesheet" href="&#x2F;cpp-httplib/css/main.css">
    9. 

  9.   <script>
    10. 

  10.     (function() {
    11. 

  11.       var t = localStorage.getItem('preferred-theme');
    12. 

  12.       if (!t) t = window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
    13. 

  13.       if (t === 'light') document.documentElement.setAttribute('data-theme', 'light');
    14. 

  14.     })();
    15. 

  15.   </script>
    16. 

  16. </head>
    17. 

  17. <body>
    18. 

  18.   <header class="header">
    19. 

  19.     <div class="header-inner">
    20. 

  20.       <a href="&#x2F;cpp-httplib/en/" class="header-title">cpp-httplib <span style="font-size:0.75em;font-weight:normal;margin-left:4px">v0.35.0</span></a>
    21. 

  21.       <div class="header-spacer"></div>
    22. 

  22.       <nav class="header-nav">
    23. 

  23.         <a href="&#x2F;cpp-httplib/en/">
    24. 

  24.           <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/><polyline points="9 22 9 12 15 12 15 22"/></svg>
    25. 

  25.           Home
    26. 

  26.         </a>
    27. 

  27.         
    28. 

  28.         
    29. 

  29.         <a href="&#x2F;cpp-httplib/en/tour&#x2F;">
    30. 

  30.           <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><polygon points="16.24 7.76 14.12 14.12 7.76 16.24 9.88 9.88 16.24 7.76"/></svg>
    31. 

  31.           Tour
    32. 

  32.         </a>
    33. 

  33.         
    34. 

  34.         
    35. 

  35.         
    36. 

  36.         <a href="https:&#x2F;&#x2F;github.com&#x2F;yhirose&#x2F;cpp-httplib" aria-label="GitHub">
    37. 

  37.           <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"/></svg>
    38. 

  38.           GitHub
    39. 

  39.         </a>
    40. 

  40.         
    41. 

  41.         
    42. 

  42.       </nav>
    43. 

  43.       <div class="header-tools">
    44. 

  44.         <button class="theme-toggle" aria-label="Toggle theme"></button>
    45. 

  45.         <div class="lang-selector">
    46. 

  46.           <button class="lang-btn" aria-label="Language">
    47. 

  47.             <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>
    48. 

  48.             EN
    49. 

  49.           </button>
    50. 

  50.           <ul class="lang-popup">
    51. 

  51.             
    52. 

  52.             <li><a href="#" data-lang="en">EN</a></li>
    53. 

  53.             
    54. 

  54.             <li><a href="#" data-lang="ja">JA</a></li>
    55. 

  55.             
    56. 

  56.           </ul>
    57. 

  57.         </div>
    58. 

  58.       </div>
    59. 

  59.       <button class="sidebar-toggle" aria-label="Menu">&#9776;</button>
    60. 

  60.     </div>
    61. 

  61.   </header>
    62. 

  62. 

  63.   
    64. 

  64. 

  65.   <div class="layout has-sidebar">
    66. 

  66.     
    67. 

  67. <aside class="sidebar">
    68. 

  68.   <nav class="sidebar-nav">
    69. 

  69.     
    70. 

  70.     <div class="nav-section">
    71. 

  71.       <a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;" class="nav-section-title active">A Tour of cpp-httplib</a>
    72. 

  72.       
    73. 

  73.       <ul class="nav-list">
    74. 

  74.         
    75. 

  75.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;01-getting-started&#x2F;" class="">Getting Started</a></li>
    76. 

  76.         
    77. 

  77.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;02-basic-client&#x2F;" class="active">Basic Client</a></li>
    78. 

  78.         
    79. 

  79.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;03-basic-server&#x2F;" class="">Basic Server</a></li>
    80. 

  80.         
    81. 

  81.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;04-static-file-server&#x2F;" class="">Static File Server</a></li>
    82. 

  82.         
    83. 

  83.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;05-tls-setup&#x2F;" class="">TLS Setup</a></li>
    84. 

  84.         
    85. 

  85.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;06-https-client&#x2F;" class="">HTTPS Client</a></li>
    86. 

  86.         
    87. 

  87.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;07-https-server&#x2F;" class="">HTTPS Server</a></li>
    88. 

  88.         
    89. 

  89.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;08-websocket&#x2F;" class="">WebSocket</a></li>
    90. 

  90.         
    91. 

  91.         <li><a href="&#x2F;cpp-httplib&#x2F;en&#x2F;tour&#x2F;09-whats-next&#x2F;" class="">What&#x27;s Next</a></li>
    92. 

  92.         
    93. 

  93.       </ul>
    94. 

  94.       
    95. 

  95.     </div>
    96. 

  96.     
    97. 

  97.   </nav>
    98. 

  98. </aside>
    99. 

  99. <main class="content">
    100. 

  100.   <article>
    101. 

  101.     <h1>Basic Client</h1>
    102. 

  102.     <p>cpp-httplib isn't just for servers -- it also comes with a full HTTP client. Let's use <code>httplib::Client</code> to send GET and POST requests.</p>
    103. 

  103. <h2>Preparing a Test Server</h2>
    104. 

  104. <p>To try out the client, you need a server that accepts requests. Save the following code, then compile and run it the same way you did in the previous chapter. We'll cover the server details in the next chapter.</p>
    105. 

  105. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    106. 

  106. <span style="color:#cc99cc;">#include </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">httplib.h</span><span style="color:#d3d0c8;">&quot;
    107. 

  107. </span><span style="color:#cc99cc;">#include </span><span style="color:#d3d0c8;">&lt;</span><span style="color:#99cc99;">iostream</span><span style="color:#d3d0c8;">&gt;
    108. 

  108. </span><span style="color:#d3d0c8;">
    109. 

  109. </span><span style="color:#cc99cc;">int </span><span style="color:#6699cc;">main</span><span style="color:#d3d0c8;">() {
    110. 

  110. </span><span style="color:#d3d0c8;">    httplib::Server svr;
    111. 

  111. </span><span style="color:#d3d0c8;">
    112. 

  112. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/hi</span><span style="color:#d3d0c8;">&quot;, [](</span><span style="color:#cc99cc;">const auto </span><span style="color:#d3d0c8;">&amp;, </span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;res) {
    113. 

  113. </span><span style="color:#d3d0c8;">        res.</span><span style="color:#6699cc;">set_content</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">Hello!</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    114. 

  114. </span><span style="color:#d3d0c8;">    });
    115. 

  115. </span><span style="color:#d3d0c8;">
    116. 

  116. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/search</span><span style="color:#d3d0c8;">&quot;, [](</span><span style="color:#cc99cc;">const auto </span><span style="color:#d3d0c8;">&amp;req, </span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;res) {
    117. 

  117. </span><span style="color:#d3d0c8;">        </span><span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> q = req.</span><span style="color:#6699cc;">get_param_value</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">q</span><span style="color:#d3d0c8;">&quot;);
    118. 

  118. </span><span style="color:#d3d0c8;">        res.</span><span style="color:#6699cc;">set_content</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">Query: </span><span style="color:#d3d0c8;">&quot; + q, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    119. 

  119. </span><span style="color:#d3d0c8;">    });
    120. 

  120. </span><span style="color:#d3d0c8;">
    121. 

  121. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">Post</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/post</span><span style="color:#d3d0c8;">&quot;, [](</span><span style="color:#cc99cc;">const auto </span><span style="color:#d3d0c8;">&amp;req, </span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;res) {
    122. 

  122. </span><span style="color:#d3d0c8;">        res.</span><span style="color:#6699cc;">set_content</span><span style="color:#d3d0c8;">(req.</span><span style="color:#f2777a;">body</span><span style="color:#d3d0c8;">, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    123. 

  123. </span><span style="color:#d3d0c8;">    });
    124. 

  124. </span><span style="color:#d3d0c8;">
    125. 

  125. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">Post</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/submit</span><span style="color:#d3d0c8;">&quot;, [](</span><span style="color:#cc99cc;">const auto </span><span style="color:#d3d0c8;">&amp;req, </span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;res) {
    126. 

  126. </span><span style="color:#d3d0c8;">        std::string result;
    127. 

  127. </span><span style="color:#d3d0c8;">        </span><span style="color:#cc99cc;">for </span><span style="color:#d3d0c8;">(</span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;[key, val] : req.</span><span style="color:#f2777a;">params</span><span style="color:#d3d0c8;">) {
    128. 

  128. </span><span style="color:#d3d0c8;">            result += key + &quot;</span><span style="color:#99cc99;"> = </span><span style="color:#d3d0c8;">&quot; + val + &quot;</span><span style="color:#66cccc;">\n</span><span style="color:#d3d0c8;">&quot;;
    129. 

  129. </span><span style="color:#d3d0c8;">        }
    130. 

  130. </span><span style="color:#d3d0c8;">        res.</span><span style="color:#6699cc;">set_content</span><span style="color:#d3d0c8;">(result, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    131. 

  131. </span><span style="color:#d3d0c8;">    });
    132. 

  132. </span><span style="color:#d3d0c8;">
    133. 

  133. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">Post</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/upload</span><span style="color:#d3d0c8;">&quot;, [](</span><span style="color:#cc99cc;">const auto </span><span style="color:#d3d0c8;">&amp;req, </span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;res) {
    134. 

  134. </span><span style="color:#d3d0c8;">        </span><span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> f = req.</span><span style="color:#f2777a;">form</span><span style="color:#d3d0c8;">.</span><span style="color:#6699cc;">get_file</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">file</span><span style="color:#d3d0c8;">&quot;);
    135. 

  135. </span><span style="color:#d3d0c8;">        </span><span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> content = f.</span><span style="color:#f2777a;">filename </span><span style="color:#d3d0c8;">+ &quot;</span><span style="color:#99cc99;"> (</span><span style="color:#d3d0c8;">&quot; + </span><span style="color:#6699cc;">std::to_string</span><span style="color:#d3d0c8;">(f.</span><span style="color:#f2777a;">content</span><span style="color:#d3d0c8;">.</span><span style="color:#6699cc;">size</span><span style="color:#d3d0c8;">()) + &quot;</span><span style="color:#99cc99;"> bytes)</span><span style="color:#d3d0c8;">&quot;;
    136. 

  136. </span><span style="color:#d3d0c8;">        res.</span><span style="color:#6699cc;">set_content</span><span style="color:#d3d0c8;">(content, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    137. 

  137. </span><span style="color:#d3d0c8;">    });
    138. 

  138. </span><span style="color:#d3d0c8;">
    139. 

  139. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/users/:id</span><span style="color:#d3d0c8;">&quot;, [](</span><span style="color:#cc99cc;">const auto </span><span style="color:#d3d0c8;">&amp;req, </span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;res) {
    140. 

  140. </span><span style="color:#d3d0c8;">        </span><span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> id = req.</span><span style="color:#f2777a;">path_params</span><span style="color:#d3d0c8;">.</span><span style="color:#6699cc;">at</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">id</span><span style="color:#d3d0c8;">&quot;);
    141. 

  141. </span><span style="color:#d3d0c8;">        res.</span><span style="color:#6699cc;">set_content</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">User ID: </span><span style="color:#d3d0c8;">&quot; + id, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    142. 

  142. </span><span style="color:#d3d0c8;">    });
    143. 

  143. </span><span style="color:#d3d0c8;">
    144. 

  144. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(</span><span style="color:#cc99cc;">R</span><span style="color:#d3d0c8;">&quot;(</span><span style="color:#99cc99;">/files/(\d+)</span><span style="color:#d3d0c8;">)&quot;, [](</span><span style="color:#cc99cc;">const auto </span><span style="color:#d3d0c8;">&amp;req, </span><span style="color:#cc99cc;">auto </span><span style="color:#d3d0c8;">&amp;res) {
    145. 

  145. </span><span style="color:#d3d0c8;">        </span><span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> id = req.</span><span style="color:#f2777a;">matches</span><span style="color:#d3d0c8;">[</span><span style="color:#f99157;">1</span><span style="color:#d3d0c8;">];
    146. 

  146. </span><span style="color:#d3d0c8;">        res.</span><span style="color:#6699cc;">set_content</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">File ID: </span><span style="color:#d3d0c8;">&quot; + </span><span style="color:#6699cc;">std::string</span><span style="color:#d3d0c8;">(id), &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    147. 

  147. </span><span style="color:#d3d0c8;">    });
    148. 

  148. </span><span style="color:#d3d0c8;">
    149. 

  149. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; &quot;</span><span style="color:#99cc99;">Listening on port 8080...</span><span style="color:#d3d0c8;">&quot; &lt;&lt; std::endl;
    150. 

  150. </span><span style="color:#d3d0c8;">    svr.</span><span style="color:#6699cc;">listen</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">0.0.0.0</span><span style="color:#d3d0c8;">&quot;, </span><span style="color:#f99157;">8080</span><span style="color:#d3d0c8;">);
    151. 

  151. </span><span style="color:#d3d0c8;">}
    152. 

  152. </span></pre>
    153. 

  153. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    154. 

  154. <span style="color:#b48ead;">#include </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">httplib.h</span><span style="color:#4f5b66;">&quot;
    155. 

  155. </span><span style="color:#b48ead;">#include </span><span style="color:#4f5b66;">&lt;</span><span style="color:#a3be8c;">iostream</span><span style="color:#4f5b66;">&gt;
    156. 

  156. </span><span style="color:#4f5b66;">
    157. 

  157. </span><span style="color:#b48ead;">int </span><span style="color:#8fa1b3;">main</span><span style="color:#4f5b66;">() {
    158. 

  158. </span><span style="color:#4f5b66;">    httplib::Server svr;
    159. 

  159. </span><span style="color:#4f5b66;">
    160. 

  160. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/hi</span><span style="color:#4f5b66;">&quot;, [](</span><span style="color:#b48ead;">const auto </span><span style="color:#4f5b66;">&amp;, </span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;res) {
    161. 

  161. </span><span style="color:#4f5b66;">        res.</span><span style="color:#8fa1b3;">set_content</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">Hello!</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    162. 

  162. </span><span style="color:#4f5b66;">    });
    163. 

  163. </span><span style="color:#4f5b66;">
    164. 

  164. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/search</span><span style="color:#4f5b66;">&quot;, [](</span><span style="color:#b48ead;">const auto </span><span style="color:#4f5b66;">&amp;req, </span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;res) {
    165. 

  165. </span><span style="color:#4f5b66;">        </span><span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> q = req.</span><span style="color:#8fa1b3;">get_param_value</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">q</span><span style="color:#4f5b66;">&quot;);
    166. 

  166. </span><span style="color:#4f5b66;">        res.</span><span style="color:#8fa1b3;">set_content</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">Query: </span><span style="color:#4f5b66;">&quot; + q, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    167. 

  167. </span><span style="color:#4f5b66;">    });
    168. 

  168. </span><span style="color:#4f5b66;">
    169. 

  169. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">Post</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/post</span><span style="color:#4f5b66;">&quot;, [](</span><span style="color:#b48ead;">const auto </span><span style="color:#4f5b66;">&amp;req, </span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;res) {
    170. 

  170. </span><span style="color:#4f5b66;">        res.</span><span style="color:#8fa1b3;">set_content</span><span style="color:#4f5b66;">(req.</span><span style="color:#bf616a;">body</span><span style="color:#4f5b66;">, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    171. 

  171. </span><span style="color:#4f5b66;">    });
    172. 

  172. </span><span style="color:#4f5b66;">
    173. 

  173. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">Post</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/submit</span><span style="color:#4f5b66;">&quot;, [](</span><span style="color:#b48ead;">const auto </span><span style="color:#4f5b66;">&amp;req, </span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;res) {
    174. 

  174. </span><span style="color:#4f5b66;">        std::string result;
    175. 

  175. </span><span style="color:#4f5b66;">        </span><span style="color:#b48ead;">for </span><span style="color:#4f5b66;">(</span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;[key, val] : req.</span><span style="color:#bf616a;">params</span><span style="color:#4f5b66;">) {
    176. 

  176. </span><span style="color:#4f5b66;">            result += key + &quot;</span><span style="color:#a3be8c;"> = </span><span style="color:#4f5b66;">&quot; + val + &quot;</span><span style="color:#96b5b4;">\n</span><span style="color:#4f5b66;">&quot;;
    177. 

  177. </span><span style="color:#4f5b66;">        }
    178. 

  178. </span><span style="color:#4f5b66;">        res.</span><span style="color:#8fa1b3;">set_content</span><span style="color:#4f5b66;">(result, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    179. 

  179. </span><span style="color:#4f5b66;">    });
    180. 

  180. </span><span style="color:#4f5b66;">
    181. 

  181. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">Post</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/upload</span><span style="color:#4f5b66;">&quot;, [](</span><span style="color:#b48ead;">const auto </span><span style="color:#4f5b66;">&amp;req, </span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;res) {
    182. 

  182. </span><span style="color:#4f5b66;">        </span><span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> f = req.</span><span style="color:#bf616a;">form</span><span style="color:#4f5b66;">.</span><span style="color:#8fa1b3;">get_file</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">file</span><span style="color:#4f5b66;">&quot;);
    183. 

  183. </span><span style="color:#4f5b66;">        </span><span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> content = f.</span><span style="color:#bf616a;">filename </span><span style="color:#4f5b66;">+ &quot;</span><span style="color:#a3be8c;"> (</span><span style="color:#4f5b66;">&quot; + </span><span style="color:#8fa1b3;">std::to_string</span><span style="color:#4f5b66;">(f.</span><span style="color:#bf616a;">content</span><span style="color:#4f5b66;">.</span><span style="color:#8fa1b3;">size</span><span style="color:#4f5b66;">()) + &quot;</span><span style="color:#a3be8c;"> bytes)</span><span style="color:#4f5b66;">&quot;;
    184. 

  184. </span><span style="color:#4f5b66;">        res.</span><span style="color:#8fa1b3;">set_content</span><span style="color:#4f5b66;">(content, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    185. 

  185. </span><span style="color:#4f5b66;">    });
    186. 

  186. </span><span style="color:#4f5b66;">
    187. 

  187. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/users/:id</span><span style="color:#4f5b66;">&quot;, [](</span><span style="color:#b48ead;">const auto </span><span style="color:#4f5b66;">&amp;req, </span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;res) {
    188. 

  188. </span><span style="color:#4f5b66;">        </span><span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> id = req.</span><span style="color:#bf616a;">path_params</span><span style="color:#4f5b66;">.</span><span style="color:#8fa1b3;">at</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">id</span><span style="color:#4f5b66;">&quot;);
    189. 

  189. </span><span style="color:#4f5b66;">        res.</span><span style="color:#8fa1b3;">set_content</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">User ID: </span><span style="color:#4f5b66;">&quot; + id, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    190. 

  190. </span><span style="color:#4f5b66;">    });
    191. 

  191. </span><span style="color:#4f5b66;">
    192. 

  192. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(</span><span style="color:#b48ead;">R</span><span style="color:#4f5b66;">&quot;(</span><span style="color:#a3be8c;">/files/(\d+)</span><span style="color:#4f5b66;">)&quot;, [](</span><span style="color:#b48ead;">const auto </span><span style="color:#4f5b66;">&amp;req, </span><span style="color:#b48ead;">auto </span><span style="color:#4f5b66;">&amp;res) {
    193. 

  193. </span><span style="color:#4f5b66;">        </span><span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> id = req.</span><span style="color:#bf616a;">matches</span><span style="color:#4f5b66;">[</span><span style="color:#d08770;">1</span><span style="color:#4f5b66;">];
    194. 

  194. </span><span style="color:#4f5b66;">        res.</span><span style="color:#8fa1b3;">set_content</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">File ID: </span><span style="color:#4f5b66;">&quot; + </span><span style="color:#8fa1b3;">std::string</span><span style="color:#4f5b66;">(id), &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    195. 

  195. </span><span style="color:#4f5b66;">    });
    196. 

  196. </span><span style="color:#4f5b66;">
    197. 

  197. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; &quot;</span><span style="color:#a3be8c;">Listening on port 8080...</span><span style="color:#4f5b66;">&quot; &lt;&lt; std::endl;
    198. 

  198. </span><span style="color:#4f5b66;">    svr.</span><span style="color:#8fa1b3;">listen</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">0.0.0.0</span><span style="color:#4f5b66;">&quot;, </span><span style="color:#d08770;">8080</span><span style="color:#4f5b66;">);
    199. 

  199. </span><span style="color:#4f5b66;">}
    200. 

  200. </span></pre>
    201. 

  201. </div>
    202. 

  202. <h2>GET Request</h2>
    203. 

  203. <p>Once the server is running, open a separate terminal and give it a try. Let's start with the simplest GET request.</p>
    204. 

  204. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    205. 

  205. <span style="color:#cc99cc;">#include </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">httplib.h</span><span style="color:#d3d0c8;">&quot;
    206. 

  206. </span><span style="color:#cc99cc;">#include </span><span style="color:#d3d0c8;">&lt;</span><span style="color:#99cc99;">iostream</span><span style="color:#d3d0c8;">&gt;
    207. 

  207. </span><span style="color:#d3d0c8;">
    208. 

  208. </span><span style="color:#cc99cc;">int </span><span style="color:#6699cc;">main</span><span style="color:#d3d0c8;">() {
    209. 

  209. </span><span style="color:#d3d0c8;">    httplib::Client </span><span style="color:#6699cc;">cli</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">http://localhost:8080</span><span style="color:#d3d0c8;">&quot;);
    210. 

  210. </span><span style="color:#d3d0c8;">
    211. 

  211. </span><span style="color:#d3d0c8;">    </span><span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/hi</span><span style="color:#d3d0c8;">&quot;);
    212. 

  212. </span><span style="color:#d3d0c8;">    </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    213. 

  213. </span><span style="color:#d3d0c8;">        std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">status </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// 200
    214. 

  214. </span><span style="color:#d3d0c8;">        std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;    </span><span style="color:#747369;">// Hello!
    215. 

  215. </span><span style="color:#d3d0c8;">    }
    216. 

  216. </span><span style="color:#d3d0c8;">}
    217. 

  217. </span></pre>
    218. 

  218. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    219. 

  219. <span style="color:#b48ead;">#include </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">httplib.h</span><span style="color:#4f5b66;">&quot;
    220. 

  220. </span><span style="color:#b48ead;">#include </span><span style="color:#4f5b66;">&lt;</span><span style="color:#a3be8c;">iostream</span><span style="color:#4f5b66;">&gt;
    221. 

  221. </span><span style="color:#4f5b66;">
    222. 

  222. </span><span style="color:#b48ead;">int </span><span style="color:#8fa1b3;">main</span><span style="color:#4f5b66;">() {
    223. 

  223. </span><span style="color:#4f5b66;">    httplib::Client </span><span style="color:#8fa1b3;">cli</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">http://localhost:8080</span><span style="color:#4f5b66;">&quot;);
    224. 

  224. </span><span style="color:#4f5b66;">
    225. 

  225. </span><span style="color:#4f5b66;">    </span><span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/hi</span><span style="color:#4f5b66;">&quot;);
    226. 

  226. </span><span style="color:#4f5b66;">    </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    227. 

  227. </span><span style="color:#4f5b66;">        std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">status </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// 200
    228. 

  228. </span><span style="color:#4f5b66;">        std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;    </span><span style="color:#a7adba;">// Hello!
    229. 

  229. </span><span style="color:#4f5b66;">    }
    230. 

  230. </span><span style="color:#4f5b66;">}
    231. 

  231. </span></pre>
    232. 

  232. </div>
    233. 

  233. <p>Pass the server address to the <code>httplib::Client</code> constructor, then call <code>Get()</code> to send a request. You can retrieve the status code and body from the returned <code>res</code>.</p>
    234. 

  234. <p>Here's the equivalent <code>curl</code> command.</p>
    235. 

  235. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    236. 

  236. <span style="color:#6699cc;">curl</span><span style="color:#d3d0c8;"> http://localhost:8080/hi
    237. 

  237. </span><span style="color:#747369;"># Hello!
    238. 

  238. </span></pre>
    239. 

  239. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    240. 

  240. <span style="color:#8fa1b3;">curl</span><span style="color:#4f5b66;"> http://localhost:8080/hi
    241. 

  241. </span><span style="color:#a7adba;"># Hello!
    242. 

  242. </span></pre>
    243. 

  243. </div>
    244. 

  244. <h2>Checking the Response</h2>
    245. 

  245. <p>A response contains header information in addition to the status code and body.</p>
    246. 

  246. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    247. 

  247. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/hi</span><span style="color:#d3d0c8;">&quot;);
    248. 

  248. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    249. 

  249. </span><span style="color:#d3d0c8;">    </span><span style="color:#747369;">// Status code
    250. 

  250. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">status </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// 200
    251. 

  251. </span><span style="color:#d3d0c8;">
    252. 

  252. </span><span style="color:#d3d0c8;">    </span><span style="color:#747369;">// Body
    253. 

  253. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// Hello!
    254. 

  254. </span><span style="color:#d3d0c8;">
    255. 

  255. </span><span style="color:#d3d0c8;">    </span><span style="color:#747369;">// Headers
    256. 

  256. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#6699cc;">get_header_value</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">Content-Type</span><span style="color:#d3d0c8;">&quot;) &lt;&lt; std::endl;  </span><span style="color:#747369;">// text/plain
    257. 

  257. </span><span style="color:#d3d0c8;">}
    258. 

  258. </span></pre>
    259. 

  259. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    260. 

  260. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/hi</span><span style="color:#4f5b66;">&quot;);
    261. 

  261. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    262. 

  262. </span><span style="color:#4f5b66;">    </span><span style="color:#a7adba;">// Status code
    263. 

  263. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">status </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// 200
    264. 

  264. </span><span style="color:#4f5b66;">
    265. 

  265. </span><span style="color:#4f5b66;">    </span><span style="color:#a7adba;">// Body
    266. 

  266. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// Hello!
    267. 

  267. </span><span style="color:#4f5b66;">
    268. 

  268. </span><span style="color:#4f5b66;">    </span><span style="color:#a7adba;">// Headers
    269. 

  269. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#8fa1b3;">get_header_value</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">Content-Type</span><span style="color:#4f5b66;">&quot;) &lt;&lt; std::endl;  </span><span style="color:#a7adba;">// text/plain
    270. 

  270. </span><span style="color:#4f5b66;">}
    271. 

  271. </span></pre>
    272. 

  272. </div>
    273. 

  273. <p><code>res-&gt;body</code> is a <code>std::string</code>, so if you want to parse a JSON response, you can pass it directly to a JSON library like <a href="https://github.com/nlohmann/json">nlohmann/json</a>.</p>
    274. 

  274. <h2>Query Parameters</h2>
    275. 

  275. <p>To add query parameters to a GET request, you can either write them directly in the URL or use <code>httplib::Params</code>.</p>
    276. 

  276. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    277. 

  277. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/search</span><span style="color:#d3d0c8;">&quot;, httplib::Params{{&quot;</span><span style="color:#99cc99;">q</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">cpp-httplib</span><span style="color:#d3d0c8;">&quot;}});
    278. 

  278. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    279. 

  279. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// Query: cpp-httplib
    280. 

  280. </span><span style="color:#d3d0c8;">}
    281. 

  281. </span></pre>
    282. 

  282. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    283. 

  283. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/search</span><span style="color:#4f5b66;">&quot;, httplib::Params{{&quot;</span><span style="color:#a3be8c;">q</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">cpp-httplib</span><span style="color:#4f5b66;">&quot;}});
    284. 

  284. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    285. 

  285. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// Query: cpp-httplib
    286. 

  286. </span><span style="color:#4f5b66;">}
    287. 

  287. </span></pre>
    288. 

  288. </div>
    289. 

  289. <p><code>httplib::Params</code> automatically URL-encodes special characters for you.</p>
    290. 

  290. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    291. 

  291. <span style="color:#6699cc;">curl </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">http://localhost:8080/search?q=cpp-httplib</span><span style="color:#d3d0c8;">&quot;
    292. 

  292. </span><span style="color:#747369;"># Query: cpp-httplib
    293. 

  293. </span></pre>
    294. 

  294. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    295. 

  295. <span style="color:#8fa1b3;">curl </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">http://localhost:8080/search?q=cpp-httplib</span><span style="color:#4f5b66;">&quot;
    296. 

  296. </span><span style="color:#a7adba;"># Query: cpp-httplib
    297. 

  297. </span></pre>
    298. 

  298. </div>
    299. 

  299. <h2>Path Parameters</h2>
    300. 

  300. <p>When values are embedded directly in the URL path, no special client API is needed. Just pass the path to <code>Get()</code> as-is.</p>
    301. 

  301. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    302. 

  302. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/users/42</span><span style="color:#d3d0c8;">&quot;);
    303. 

  303. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    304. 

  304. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// User ID: 42
    305. 

  305. </span><span style="color:#d3d0c8;">}
    306. 

  306. </span></pre>
    307. 

  307. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    308. 

  308. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/users/42</span><span style="color:#4f5b66;">&quot;);
    309. 

  309. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    310. 

  310. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// User ID: 42
    311. 

  311. </span><span style="color:#4f5b66;">}
    312. 

  312. </span></pre>
    313. 

  313. </div><div class="code-dark"><pre style="background-color:#2d2d2d;">
    314. 

  314. <span style="color:#6699cc;">curl</span><span style="color:#d3d0c8;"> http://localhost:8080/users/42
    315. 

  315. </span><span style="color:#747369;"># User ID: 42
    316. 

  316. </span></pre>
    317. 

  317. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    318. 

  318. <span style="color:#8fa1b3;">curl</span><span style="color:#4f5b66;"> http://localhost:8080/users/42
    319. 

  319. </span><span style="color:#a7adba;"># User ID: 42
    320. 

  320. </span></pre>
    321. 

  321. </div>
    322. 

  322. <p>The test server also has a <code>/files/(\d+)</code> route that uses a regex to accept numeric IDs only.</p>
    323. 

  323. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    324. 

  324. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/files/42</span><span style="color:#d3d0c8;">&quot;);
    325. 

  325. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    326. 

  326. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// File ID: 42
    327. 

  327. </span><span style="color:#d3d0c8;">}
    328. 

  328. </span></pre>
    329. 

  329. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    330. 

  330. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/files/42</span><span style="color:#4f5b66;">&quot;);
    331. 

  331. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    332. 

  332. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// File ID: 42
    333. 

  333. </span><span style="color:#4f5b66;">}
    334. 

  334. </span></pre>
    335. 

  335. </div><div class="code-dark"><pre style="background-color:#2d2d2d;">
    336. 

  336. <span style="color:#6699cc;">curl</span><span style="color:#d3d0c8;"> http://localhost:8080/files/42
    337. 

  337. </span><span style="color:#747369;"># File ID: 42
    338. 

  338. </span></pre>
    339. 

  339. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    340. 

  340. <span style="color:#8fa1b3;">curl</span><span style="color:#4f5b66;"> http://localhost:8080/files/42
    341. 

  341. </span><span style="color:#a7adba;"># File ID: 42
    342. 

  342. </span></pre>
    343. 

  343. </div>
    344. 

  344. <p>Pass a non-numeric ID like <code>/files/abc</code> and you'll get a 404. We'll cover how that works in the next chapter.</p>
    345. 

  345. <h2>Request Headers</h2>
    346. 

  346. <p>To add custom HTTP headers, pass an <code>httplib::Headers</code> object. This works with both <code>Get()</code> and <code>Post()</code>.</p>
    347. 

  347. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    348. 

  348. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/hi</span><span style="color:#d3d0c8;">&quot;, httplib::Headers{
    349. 

  349. </span><span style="color:#d3d0c8;">    {&quot;</span><span style="color:#99cc99;">Authorization</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">Bearer my-token</span><span style="color:#d3d0c8;">&quot;}
    350. 

  350. </span><span style="color:#d3d0c8;">});
    351. 

  351. </span></pre>
    352. 

  352. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    353. 

  353. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/hi</span><span style="color:#4f5b66;">&quot;, httplib::Headers{
    354. 

  354. </span><span style="color:#4f5b66;">    {&quot;</span><span style="color:#a3be8c;">Authorization</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">Bearer my-token</span><span style="color:#4f5b66;">&quot;}
    355. 

  355. </span><span style="color:#4f5b66;">});
    356. 

  356. </span></pre>
    357. 

  357. </div><div class="code-dark"><pre style="background-color:#2d2d2d;">
    358. 

  358. <span style="color:#6699cc;">curl</span><span style="color:#f2777a;"> -H </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">Authorization: Bearer my-token</span><span style="color:#d3d0c8;">&quot; http://localhost:8080/hi
    359. 

  359. </span></pre>
    360. 

  360. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    361. 

  361. <span style="color:#8fa1b3;">curl</span><span style="color:#bf616a;"> -H </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">Authorization: Bearer my-token</span><span style="color:#4f5b66;">&quot; http://localhost:8080/hi
    362. 

  362. </span></pre>
    363. 

  363. </div>
    364. 

  364. <h2>POST Request</h2>
    365. 

  365. <p>Let's POST some text data. Pass the body as the second argument to <code>Post()</code> and the Content-Type as the third.</p>
    366. 

  366. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    367. 

  367. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Post</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/post</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">Hello, Server!</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;);
    368. 

  368. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    369. 

  369. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">status </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// 200
    370. 

  370. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;    </span><span style="color:#747369;">// Hello, Server!
    371. 

  371. </span><span style="color:#d3d0c8;">}
    372. 

  372. </span></pre>
    373. 

  373. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    374. 

  374. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Post</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/post</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">Hello, Server!</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;);
    375. 

  375. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    376. 

  376. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">status </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// 200
    377. 

  377. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;    </span><span style="color:#a7adba;">// Hello, Server!
    378. 

  378. </span><span style="color:#4f5b66;">}
    379. 

  379. </span></pre>
    380. 

  380. </div>
    381. 

  381. <p>The test server's <code>/post</code> endpoint echoes the body back, so you get the same string you sent.</p>
    382. 

  382. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    383. 

  383. <span style="color:#6699cc;">curl</span><span style="color:#f2777a;"> -X</span><span style="color:#d3d0c8;"> POST</span><span style="color:#f2777a;"> -H </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">Content-Type: text/plain</span><span style="color:#d3d0c8;">&quot;</span><span style="color:#f2777a;"> -d </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">Hello, Server!</span><span style="color:#d3d0c8;">&quot; http://localhost:8080/post
    384. 

  384. </span><span style="color:#747369;"># Hello, Server!
    385. 

  385. </span></pre>
    386. 

  386. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    387. 

  387. <span style="color:#8fa1b3;">curl</span><span style="color:#bf616a;"> -X</span><span style="color:#4f5b66;"> POST</span><span style="color:#bf616a;"> -H </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">Content-Type: text/plain</span><span style="color:#4f5b66;">&quot;</span><span style="color:#bf616a;"> -d </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">Hello, Server!</span><span style="color:#4f5b66;">&quot; http://localhost:8080/post
    388. 

  388. </span><span style="color:#a7adba;"># Hello, Server!
    389. 

  389. </span></pre>
    390. 

  390. </div>
    391. 

  391. <h2>Sending Form Data</h2>
    392. 

  392. <p>You can send key-value pairs just like an HTML form. Use <code>httplib::Params</code> for this.</p>
    393. 

  393. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    394. 

  394. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Post</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/submit</span><span style="color:#d3d0c8;">&quot;, httplib::Params{
    395. 

  395. </span><span style="color:#d3d0c8;">    {&quot;</span><span style="color:#99cc99;">name</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">Alice</span><span style="color:#d3d0c8;">&quot;},
    396. 

  396. </span><span style="color:#d3d0c8;">    {&quot;</span><span style="color:#99cc99;">age</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">30</span><span style="color:#d3d0c8;">&quot;}
    397. 

  397. </span><span style="color:#d3d0c8;">});
    398. 

  398. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    399. 

  399. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;
    400. 

  400. </span><span style="color:#d3d0c8;">    </span><span style="color:#747369;">// age = 30
    401. 

  401. </span><span style="color:#d3d0c8;">    </span><span style="color:#747369;">// name = Alice
    402. 

  402. </span><span style="color:#d3d0c8;">}
    403. 

  403. </span></pre>
    404. 

  404. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    405. 

  405. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Post</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/submit</span><span style="color:#4f5b66;">&quot;, httplib::Params{
    406. 

  406. </span><span style="color:#4f5b66;">    {&quot;</span><span style="color:#a3be8c;">name</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">Alice</span><span style="color:#4f5b66;">&quot;},
    407. 

  407. </span><span style="color:#4f5b66;">    {&quot;</span><span style="color:#a3be8c;">age</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">30</span><span style="color:#4f5b66;">&quot;}
    408. 

  408. </span><span style="color:#4f5b66;">});
    409. 

  409. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    410. 

  410. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;
    411. 

  411. </span><span style="color:#4f5b66;">    </span><span style="color:#a7adba;">// age = 30
    412. 

  412. </span><span style="color:#4f5b66;">    </span><span style="color:#a7adba;">// name = Alice
    413. 

  413. </span><span style="color:#4f5b66;">}
    414. 

  414. </span></pre>
    415. 

  415. </div>
    416. 

  416. <p>This sends the data in <code>application/x-www-form-urlencoded</code> format.</p>
    417. 

  417. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    418. 

  418. <span style="color:#6699cc;">curl</span><span style="color:#f2777a;"> -X</span><span style="color:#d3d0c8;"> POST</span><span style="color:#f2777a;"> -d </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">name=Alice&amp;age=30</span><span style="color:#d3d0c8;">&quot; http://localhost:8080/submit
    419. 

  419. </span></pre>
    420. 

  420. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    421. 

  421. <span style="color:#8fa1b3;">curl</span><span style="color:#bf616a;"> -X</span><span style="color:#4f5b66;"> POST</span><span style="color:#bf616a;"> -d </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">name=Alice&amp;age=30</span><span style="color:#4f5b66;">&quot; http://localhost:8080/submit
    422. 

  422. </span></pre>
    423. 

  423. </div>
    424. 

  424. <h2>POSTing a File</h2>
    425. 

  425. <p>To upload a file, use <code>httplib::UploadFormDataItems</code> to send it as multipart form data.</p>
    426. 

  426. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    427. 

  427. <span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Post</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/upload</span><span style="color:#d3d0c8;">&quot;, httplib::UploadFormDataItems{
    428. 

  428. </span><span style="color:#d3d0c8;">    {&quot;</span><span style="color:#99cc99;">file</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">Hello, File!</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">hello.txt</span><span style="color:#d3d0c8;">&quot;, &quot;</span><span style="color:#99cc99;">text/plain</span><span style="color:#d3d0c8;">&quot;}
    429. 

  429. </span><span style="color:#d3d0c8;">});
    430. 

  430. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res) {
    431. 

  431. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;  </span><span style="color:#747369;">// hello.txt (12 bytes)
    432. 

  432. </span><span style="color:#d3d0c8;">}
    433. 

  433. </span></pre>
    434. 

  434. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    435. 

  435. <span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Post</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/upload</span><span style="color:#4f5b66;">&quot;, httplib::UploadFormDataItems{
    436. 

  436. </span><span style="color:#4f5b66;">    {&quot;</span><span style="color:#a3be8c;">file</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">Hello, File!</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">hello.txt</span><span style="color:#4f5b66;">&quot;, &quot;</span><span style="color:#a3be8c;">text/plain</span><span style="color:#4f5b66;">&quot;}
    437. 

  437. </span><span style="color:#4f5b66;">});
    438. 

  438. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res) {
    439. 

  439. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;  </span><span style="color:#a7adba;">// hello.txt (12 bytes)
    440. 

  440. </span><span style="color:#4f5b66;">}
    441. 

  441. </span></pre>
    442. 

  442. </div>
    443. 

  443. <p>Each element in <code>UploadFormDataItems</code> has four fields: <code>{name, content, filename, content_type}</code>.</p>
    444. 

  444. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    445. 

  445. <span style="color:#6699cc;">curl</span><span style="color:#f2777a;"> -F </span><span style="color:#d3d0c8;">&quot;</span><span style="color:#99cc99;">file=Hello, File!;filename=hello.txt;type=text/plain</span><span style="color:#d3d0c8;">&quot; http://localhost:8080/upload
    446. 

  446. </span></pre>
    447. 

  447. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    448. 

  448. <span style="color:#8fa1b3;">curl</span><span style="color:#bf616a;"> -F </span><span style="color:#4f5b66;">&quot;</span><span style="color:#a3be8c;">file=Hello, File!;filename=hello.txt;type=text/plain</span><span style="color:#4f5b66;">&quot; http://localhost:8080/upload
    449. 

  449. </span></pre>
    450. 

  450. </div>
    451. 

  451. <h2>Error Handling</h2>
    452. 

  452. <p>Network communication can fail -- the server might not be reachable. Always check whether <code>res</code> is valid.</p>
    453. 

  453. <div class="code-dark"><pre style="background-color:#2d2d2d;">
    454. 

  454. <span style="color:#d3d0c8;">httplib::Client </span><span style="color:#6699cc;">cli</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">http://localhost:9999</span><span style="color:#d3d0c8;">&quot;);  </span><span style="color:#747369;">// Non-existent port
    455. 

  455. </span><span style="color:#cc99cc;">auto</span><span style="color:#d3d0c8;"> res = cli.</span><span style="color:#6699cc;">Get</span><span style="color:#d3d0c8;">(&quot;</span><span style="color:#99cc99;">/hi</span><span style="color:#d3d0c8;">&quot;);
    456. 

  456. </span><span style="color:#d3d0c8;">
    457. 

  457. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(!res) {
    458. 

  458. </span><span style="color:#d3d0c8;">    </span><span style="color:#747369;">// Connection error
    459. 

  459. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; &quot;</span><span style="color:#99cc99;">Error: </span><span style="color:#d3d0c8;">&quot; &lt;&lt; </span><span style="color:#6699cc;">httplib::to_string</span><span style="color:#d3d0c8;">(res.</span><span style="color:#6699cc;">error</span><span style="color:#d3d0c8;">()) &lt;&lt; std::endl;
    460. 

  460. </span><span style="color:#d3d0c8;">    </span><span style="color:#747369;">// Error: Connection
    461. 

  461. </span><span style="color:#d3d0c8;">    </span><span style="color:#cc99cc;">return </span><span style="color:#f99157;">1</span><span style="color:#d3d0c8;">;
    462. 

  462. </span><span style="color:#d3d0c8;">}
    463. 

  463. </span><span style="color:#d3d0c8;">
    464. 

  464. </span><span style="color:#747369;">// If we reach here, we have a response
    465. 

  465. </span><span style="color:#cc99cc;">if </span><span style="color:#d3d0c8;">(res-&gt;</span><span style="color:#f2777a;">status </span><span style="color:#d3d0c8;">!= </span><span style="color:#f99157;">200</span><span style="color:#d3d0c8;">) {
    466. 

  466. </span><span style="color:#d3d0c8;">    std::cout &lt;&lt; &quot;</span><span style="color:#99cc99;">HTTP Error: </span><span style="color:#d3d0c8;">&quot; &lt;&lt; res-&gt;</span><span style="color:#f2777a;">status </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;
    467. 

  467. </span><span style="color:#d3d0c8;">    </span><span style="color:#cc99cc;">return </span><span style="color:#f99157;">1</span><span style="color:#d3d0c8;">;
    468. 

  468. </span><span style="color:#d3d0c8;">}
    469. 

  469. </span><span style="color:#d3d0c8;">
    470. 

  470. </span><span style="color:#d3d0c8;">std::cout &lt;&lt; res-&gt;</span><span style="color:#f2777a;">body </span><span style="color:#d3d0c8;">&lt;&lt; std::endl;
    471. 

  471. </span></pre>
    472. 

  472. </div><div class="code-light"><pre style="background-color:#eff1f5;">
    473. 

  473. <span style="color:#4f5b66;">httplib::Client </span><span style="color:#8fa1b3;">cli</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">http://localhost:9999</span><span style="color:#4f5b66;">&quot;);  </span><span style="color:#a7adba;">// Non-existent port
    474. 

  474. </span><span style="color:#b48ead;">auto</span><span style="color:#4f5b66;"> res = cli.</span><span style="color:#8fa1b3;">Get</span><span style="color:#4f5b66;">(&quot;</span><span style="color:#a3be8c;">/hi</span><span style="color:#4f5b66;">&quot;);
    475. 

  475. </span><span style="color:#4f5b66;">
    476. 

  476. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(!res) {
    477. 

  477. </span><span style="color:#4f5b66;">    </span><span style="color:#a7adba;">// Connection error
    478. 

  478. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; &quot;</span><span style="color:#a3be8c;">Error: </span><span style="color:#4f5b66;">&quot; &lt;&lt; </span><span style="color:#8fa1b3;">httplib::to_string</span><span style="color:#4f5b66;">(res.</span><span style="color:#8fa1b3;">error</span><span style="color:#4f5b66;">()) &lt;&lt; std::endl;
    479. 

  479. </span><span style="color:#4f5b66;">    </span><span style="color:#a7adba;">// Error: Connection
    480. 

  480. </span><span style="color:#4f5b66;">    </span><span style="color:#b48ead;">return </span><span style="color:#d08770;">1</span><span style="color:#4f5b66;">;
    481. 

  481. </span><span style="color:#4f5b66;">}
    482. 

  482. </span><span style="color:#4f5b66;">
    483. 

  483. </span><span style="color:#a7adba;">// If we reach here, we have a response
    484. 

  484. </span><span style="color:#b48ead;">if </span><span style="color:#4f5b66;">(res-&gt;</span><span style="color:#bf616a;">status </span><span style="color:#4f5b66;">!= </span><span style="color:#d08770;">200</span><span style="color:#4f5b66;">) {
    485. 

  485. </span><span style="color:#4f5b66;">    std::cout &lt;&lt; &quot;</span><span style="color:#a3be8c;">HTTP Error: </span><span style="color:#4f5b66;">&quot; &lt;&lt; res-&gt;</span><span style="color:#bf616a;">status </span><span style="color:#4f5b66;">&lt;&lt; std::endl;
    486. 

  486. </span><span style="color:#4f5b66;">    </span><span style="color:#b48ead;">return </span><span style="color:#d08770;">1</span><span style="color:#4f5b66;">;
    487. 

  487. </span><span style="color:#4f5b66;">}
    488. 

  488. </span><span style="color:#4f5b66;">
    489. 

  489. </span><span style="color:#4f5b66;">std::cout &lt;&lt; res-&gt;</span><span style="color:#bf616a;">body </span><span style="color:#4f5b66;">&lt;&lt; std::endl;
    490. 

  490. </span></pre>
    491. 

  491. </div>
    492. 

  492. <p>There are two levels of errors.</p>
    493. 

  493. <ul>
    494. 

  494. <li><strong>Connection error</strong>: The client couldn't reach the server. <code>res</code> evaluates to false, and you can call <code>res.error()</code> to find out what went wrong.</li>
    495. 

  495. <li><strong>HTTP error</strong>: The server returned an error status (404, 500, etc.). <code>res</code> evaluates to true, but you need to check <code>res-&gt;status</code>.</li>
    496. 

  496. </ul>
    497. 

  497. <h2>Next Steps</h2>
    498. 

  498. <p>Now you know how to send requests from a client. Next, let's take a closer look at the server side. We'll dig into routing, path parameters, and more.</p>
    499. 

  499. <p><strong>Next:</strong> <a href="../03-basic-server">Basic Server</a></p>
    500. 

  500. 

  501.   </article>
    502. 

  502. </main>
    503. 

  503. 

  504.   </div>
    505. 

  505. 

  506.   <footer class="footer">
    507. 

  507.     &copy; 2026 yhirose. All rights reserved.
    508. 

  508.   </footer>
    509. 

  509. 

  510.   <script src="&#x2F;cpp-httplib/js/main.js"></script>
    511. 

  511. </body>
    512. 

  512. </html>
    513.