Převést curl do C

Q: Co je libcurl?

libcurl je knihovna v C, která stojí za příkazovým nástrojem curl. Je to nejpřenosnější a nejrozšířenější knihovna HTTP klienta, podporující více než 25 protokolů. Používají ji tisíce aplikací a vestavěných systémů. Přidejte ji pomocí správce balíčků vašeho systému nebo ji nalinkujte staticky. curl2code generuje kód libcurl v C pomocí rozhraní easy.

Q: libcurl easy vs multi interface — které použít?

Rozhraní easy (curl_easy_*) je pro jednotlivé synchronní přenosy — jednoduché a přímočaré. Rozhraní multi (curl_multi_*) umožňuje neblokující souběžné přenosy v jediném vlákně. Easy použijte pro skripty a jednoduché nástroje, multi pro vysoce výkonné aplikace. Pro vyšší programovací jazyk rodiny C viz curl do Rustu.

Q: Jak řešit autentizaci s libcurl?

Pro Bearer: nastavte vlastní hlavičku pomocí curl_slist_append(headers, "Authorization: Bearer token"). Pro Basic auth: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl automaticky zakóduje přihlašovací údaje Basic auth. curl2code převádí -u a přepínače hlaviček na správná volání C API.

Q: Jak poslat multipart form data s libcurl?

Použijte MIME API (libcurl 7.56+): curl_mime_init() pro vytvoření mime struktury, curl_mime_addpart() pro každé pole, curl_mime_name() a curl_mime_filedata() pro nahrávání souborů. Nastavte pomocí CURLOPT_MIMEPOST. Uvolněte pomocí curl_mime_free().

Q: Jak řešit chyby s libcurl?

Každá funkce curl_easy_* vrací CURLcode — zkontrolujte jej proti CURLE_OK. Použijte curl_easy_strerror(code) pro lidsky čitelné zprávy. Nastavte CURLOPT_ERRORBUFFER pro podrobné chybové řetězce. HTTP stav získáte pomocí curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Q: Jak spravovat paměť s libcurl?

Po dokončení práce s handlem vždy zavolejte curl_easy_cleanup(). Seznamy hlaviček uvolněte pomocí curl_slist_free_all(). MIME struktury uvolněte pomocí curl_mime_free(). Pro write callbacky si spravujte vlastní alokaci bufferu. Při ukončení programu zavolejte jednou curl_global_cleanup(). Neuvolnění prostředků způsobuje úniky paměti.

Q: Jak nastavit timeouty s libcurl?

Nastavte CURLOPT_CONNECTTIMEOUT pro timeout připojení a CURLOPT_TIMEOUT pro celkový čas přenosu (oboje v sekundách). Pro přesnost na milisekundy použijte CURLOPT_CONNECTTIMEOUT_MS a CURLOPT_TIMEOUT_MS. Jsou to přesně ty samé volby, které používá curl CLI s --connect-timeout a --max-time.

Q: Jak nakonfigurovat proxy s libcurl?

Nastavte CURLOPT_PROXY na URL proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Pro SOCKS5: nastavte CURLOPT_PROXYTYPE na CURLPROXY_SOCKS5. Pro autentizaci proxy: CURLOPT_PROXYUSERPWD. libcurl také respektuje proměnnou prostředí http_proxy.

Q: Jak odeslat POST požadavek s JSON tělem v C?

Převeďte curl POST příkaz jako curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL do C pomocí curl2code. Vygenerovaný kód používá curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code automaticky detekuje -d/--data přepínače s JSON obsahem a nastaví odpovídající Content-Type hlavičku v kódu pro libcurl.

Q: Jak přidat autorizaci pomocí Bearer tokenu v C?

Vložte curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code a nástroj vygeneruje kód pro libcurl s autorizační hlavičkou: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code detekuje Bearer tokeny z přepínačů -H "Authorization: Bearer ..." i --oauth2-bearer. Pro Basic auth použijte -u user:pass.

curl2code převádí curl příkazy na kód v C pomocí libcurl. Převod probíhá ve vašem prohlížeči přes WebAssembly pro úplné soukromí. Pro Rust se podívejte na náš převodník curl do Rustu. Pro Go viz curl do Go. Níže jsou praktické příklady v C s řádnou správou paměti.

Jak zkopírovat curl z prohlížeče

1
Otevřete DevTools
Stiskněte F12 nebo Ctrl+Shift+I pro otevření vývojářských nástrojů prohlížeče.
2
Přejděte na kartu Network
Klikněte na kartu Network a proveďte akci, která vyvolá HTTP požadavek.
3
Zkopírovat jako cURL
Klikněte pravým tlačítkem na požadavek → Copy → Copy as cURL. Poté jej vložte výše.

Příklady kódu v C

1Jednoduchý GET požadavek

příkaz curl

curl https://api.example.com/users

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/users");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;

  return (int)ret;
}

2POST s tělem JSON

příkaz curl

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "Content-Type: application/json");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/users");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"name\":\"John\",\"email\":\"john@example.com\"}");
  curl_easy_setopt(hnd, CURLOPT_POSTFIELDSIZE_LARGE, (curl_off_t)42);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

3Požadavek s Bearer tokenem

příkaz curl

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "Authorization: Bearer token123");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/me");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

4Nahrávání formuláře (Multipart)

příkaz curl

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  curl_mime *mime1;
  curl_mimepart *part1;

  mime1 = NULL;

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/upload");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  mime1 = curl_mime_init(hnd);
  part1 = curl_mime_addpart(mime1);
  curl_mime_filedata(part1, "document.pdf");
  curl_mime_name(part1, "file");
  part1 = curl_mime_addpart(mime1);
  curl_mime_data(part1, "My file", CURL_ZERO_TERMINATED);
  curl_mime_name(part1, "description");
  curl_easy_setopt(hnd, CURLOPT_MIMEPOST, mime1);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_mime_free(mime1);
  mime1 = NULL;

  return (int)ret;
}

5Vlastní hlavičky

příkaz curl

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "X-API-Key: abc123");
  headers = curl_slist_append(headers, "Accept: application/json");
  headers = curl_slist_append(headers, "X-Request-ID: req-456");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/data");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

Často kladené dotazy

Co je libcurl?

libcurl je knihovna v C, která stojí za příkazovým nástrojem curl. Je to nejpřenosnější a nejrozšířenější knihovna HTTP klienta, podporující více než 25 protokolů. Používají ji tisíce aplikací a vestavěných systémů. Přidejte ji pomocí správce balíčků vašeho systému nebo ji nalinkujte staticky. curl2code generuje kód libcurl v C pomocí rozhraní easy.

libcurl easy vs multi interface — které použít?

Rozhraní easy (curl_easy_*) je pro jednotlivé synchronní přenosy — jednoduché a přímočaré. Rozhraní multi (curl_multi_*) umožňuje neblokující souběžné přenosy v jediném vlákně. Easy použijte pro skripty a jednoduché nástroje, multi pro vysoce výkonné aplikace. Pro vyšší programovací jazyk rodiny C viz curl do Rustu.

Jak řešit autentizaci s libcurl?

Pro Bearer: nastavte vlastní hlavičku pomocí curl_slist_append(headers, "Authorization: Bearer token"). Pro Basic auth: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl automaticky zakóduje přihlašovací údaje Basic auth. curl2code převádí -u a přepínače hlaviček na správná volání C API.

Jak poslat multipart form data s libcurl?

Použijte MIME API (libcurl 7.56+): curl_mime_init() pro vytvoření mime struktury, curl_mime_addpart() pro každé pole, curl_mime_name() a curl_mime_filedata() pro nahrávání souborů. Nastavte pomocí CURLOPT_MIMEPOST. Uvolněte pomocí curl_mime_free().

Jak řešit chyby s libcurl?

Každá funkce curl_easy_* vrací CURLcode — zkontrolujte jej proti CURLE_OK. Použijte curl_easy_strerror(code) pro lidsky čitelné zprávy. Nastavte CURLOPT_ERRORBUFFER pro podrobné chybové řetězce. HTTP stav získáte pomocí curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Jak spravovat paměť s libcurl?

Po dokončení práce s handlem vždy zavolejte curl_easy_cleanup(). Seznamy hlaviček uvolněte pomocí curl_slist_free_all(). MIME struktury uvolněte pomocí curl_mime_free(). Pro write callbacky si spravujte vlastní alokaci bufferu. Při ukončení programu zavolejte jednou curl_global_cleanup(). Neuvolnění prostředků způsobuje úniky paměti.

Jak nastavit timeouty s libcurl?

Nastavte CURLOPT_CONNECTTIMEOUT pro timeout připojení a CURLOPT_TIMEOUT pro celkový čas přenosu (oboje v sekundách). Pro přesnost na milisekundy použijte CURLOPT_CONNECTTIMEOUT_MS a CURLOPT_TIMEOUT_MS. Jsou to přesně ty samé volby, které používá curl CLI s --connect-timeout a --max-time.

Jak nakonfigurovat proxy s libcurl?

Nastavte CURLOPT_PROXY na URL proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Pro SOCKS5: nastavte CURLOPT_PROXYTYPE na CURLPROXY_SOCKS5. Pro autentizaci proxy: CURLOPT_PROXYUSERPWD. libcurl také respektuje proměnnou prostředí http_proxy.

Jak odeslat POST požadavek s JSON tělem v C?

Převeďte curl POST příkaz jako curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL do C pomocí curl2code. Vygenerovaný kód používá curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code automaticky detekuje -d/--data přepínače s JSON obsahem a nastaví odpovídající Content-Type hlavičku v kódu pro libcurl.

Jak přidat autorizaci pomocí Bearer tokenu v C?

Vložte curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code a nástroj vygeneruje kód pro libcurl s autorizační hlavičkou: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code detekuje Bearer tokeny z přepínačů -H "Authorization: Bearer ..." i --oauth2-bearer. Pro Basic auth použijte -u user:pass.

Jak nastavit hlavičku Content-Type v C?

curl2code převede curl -H "Content-Type: application/json" URL na kód pro libcurl se správnou hlavičkou: curl_slist_append(headers, "Content-Type: application/json"). Pro data u -d curl standardně používá application/x-www-form-urlencoded; pro nahrávání formulářů přes -F používá multipart/form-data. curl2code mapuje každý z nich na správné libcurl API.

Užitečné odkazy

Dokumentace libcurl

curl.se

Reference standardní knihovny

curl.se

Manuálová stránka curl

curl.se

Průvodci curl

Chybové kódy curl

Vyhledejte libovolný návratový kód curl — příčiny, opravy a tipy pro ladění.

Stahování souborů pomocí curl

Ukládejte soubory pomocí -o, -O, sledujte přesměrování, obnovujte stahování a další.

SSL, TLS a proxy

Konfigurujte certifikáty, verze TLS, HTTP/SOCKS proxy a vlastní DNS.

Jak zkopírovat curl z prohlížeče

Příklady kódu v C

1Jednoduchý GET požadavek

2POST s tělem JSON

3Požadavek s Bearer tokenem

4Nahrávání formuláře (Multipart)

5Vlastní hlavičky

Často kladené dotazy

Užitečné odkazy

Průvodci curl

Převést curl do jiných jazyků

Příklady kódu v C

1Jednoduchý GET požadavek

2POST s tělem JSON

3Požadavek s Bearer tokenem

4Nahrávání formuláře (Multipart)

5Vlastní hlavičky