Prevod curl do C

Q: Čo je libcurl?

libcurl je C knižnica, ktorá stojí za nástrojom curl pre príkazový riadok. Je to najprenosnejšia a najrozšírenejšia knižnica HTTP klienta, podporujúca viac ako 25 protokolov. Používajú ju tisíce aplikácií a vstavaných systémov. Pridajte ju pomocou správcu balíkov vášho systému alebo ju nalinkujte staticky. curl2code generuje C kód pre libcurl pomocou rozhrania easy.

Q: libcurl easy vs multi interface — ktoré použiť?

Rozhranie easy (curl_easy_*) je určené pre jednotlivé synchrónne prenosy — je jednoduché a priamočiare. Rozhranie multi (curl_multi_*) umožňuje neblokujúce súbežné prenosy v jednom vlákne. Easy používajte pre skripty a jednoduché nástroje, multi pre vysoko výkonné aplikácie. Pre vyšší programovací jazyk z rodiny C si pozrite curl do Rustu.

Q: Ako riešiť autentifikáciu s libcurl?

Pre Bearer: nastavte vlastnú hlavičku pomocou curl_slist_append(headers, "Authorization: Bearer token"). Pre Basic auth: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl automaticky kóduje prihlasovacie údaje pre Basic auth. curl2code konvertuje prepínače -u a hlavičky na správne volania C API.

Q: Ako posielať multipart form data s libcurl?

Použite MIME API (libcurl 7.56+): curl_mime_init() na vytvorenie mime štruktúry, curl_mime_addpart() pre každé pole, curl_mime_name() a curl_mime_filedata() pre nahrávanie súborov. Nastavte pomocou CURLOPT_MIMEPOST. Uvoľnite pomocou curl_mime_free().

Q: Ako riešiť chyby s libcurl?

Každá funkcia curl_easy_* vracia CURLcode — skontrolujte ho voči CURLE_OK. Použite curl_easy_strerror(code) pre ľudsky čitateľné správy. Nastavte CURLOPT_ERRORBUFFER pre podrobné chybové reťazce. Získajte HTTP stav pomocou curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Q: Ako spravovať pamäť s libcurl?

Vždy volajte curl_easy_cleanup(), keď skončíte s handlom. Uvoľnite zoznamy hlavičiek pomocou curl_slist_free_all(). Uvoľnite MIME štruktúry pomocou curl_mime_free(). Pre write callbacky spravujte vlastnú alokáciu buffera. Zavolajte curl_global_cleanup() raz pri ukončení programu. Neuvoľnenie zdrojov spôsobuje úniky pamäte.

Q: Ako nastaviť timeouty s libcurl?

Nastavte CURLOPT_CONNECTTIMEOUT pre timeout pripojenia a CURLOPT_TIMEOUT pre celkový čas prenosu (obe v sekundách). Pre milisekundovú presnosť použite CURLOPT_CONNECTTIMEOUT_MS a CURLOPT_TIMEOUT_MS. Sú to presne tie isté voľby, ktoré používa curl CLI s --connect-timeout a --max-time.

Q: Ako konfigurovať proxy s libcurl?

Nastavte CURLOPT_PROXY na URL proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Pre SOCKS5: nastavte CURLOPT_PROXYTYPE na CURLPROXY_SOCKS5. Pre autentifikáciu proxy: CURLOPT_PROXYUSERPWD. libcurl tiež rešpektuje premennú prostredia http_proxy.

Q: Ako poslať POST požiadavku s JSON telom v jazyku C?

Preveďte curl POST príkaz ako curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL do jazyka C pomocou curl2code. Vygenerovaný kód používa curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code automaticky deteguje prepínače -d/--data s JSON obsahom a nastaví príslušnú hlavičku Content-Type v kóde pre libcurl.

Q: Ako pridať autorizáciu pomocou Bearer tokenu v jazyku C?

Vložte curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code a nástroj vygeneruje kód pre libcurl s autorizačnou hlavičkou: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code deteguje Bearer tokeny z prepínačov -H "Authorization: Bearer ..." aj --oauth2-bearer. Pre Basic auth použite -u user:pass.

curl2code konvertuje curl príkazy na C kód pomocou libcurl. Prevod prebieha vo vašom prehliadači cez WebAssembly pre úplné súkromie. Pre Rust si pozrite náš prevodník curl do Rustu. Pre Go si pozrite curl do Go. Nižšie sú praktické C príklady so správnou správou pamäte.

Ako skopírovať curl z vášho prehliadača

1
Otvorte DevTools
Stlačte F12 alebo Ctrl+Shift+I na otvorenie vývojárskych nástrojov prehliadača.
2
Prejdite na kartu Network
Kliknite na kartu Network a vykonajte akciu, ktorá spustí HTTP požiadavku.
3
Skopírovať ako cURL
Kliknite pravým tlačidlom na požiadavku → Copy → Copy as cURL. Potom ju prilepte vyššie.

Príklady kódu v C

1Jednoduchá GET požiadavka

curl príkaz

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 JSON telom

curl príkaz

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žiadavka s Bearer tokenom

curl príkaz

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;
}

4Multipart Form nahrávanie

curl príkaz

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

curl príkaz

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é otázky

Čo je libcurl?

libcurl je C knižnica, ktorá stojí za nástrojom curl pre príkazový riadok. Je to najprenosnejšia a najrozšírenejšia knižnica HTTP klienta, podporujúca viac ako 25 protokolov. Používajú ju tisíce aplikácií a vstavaných systémov. Pridajte ju pomocou správcu balíkov vášho systému alebo ju nalinkujte staticky. curl2code generuje C kód pre libcurl pomocou rozhrania easy.

libcurl easy vs multi interface — ktoré použiť?

Rozhranie easy (curl_easy_*) je určené pre jednotlivé synchrónne prenosy — je jednoduché a priamočiare. Rozhranie multi (curl_multi_*) umožňuje neblokujúce súbežné prenosy v jednom vlákne. Easy používajte pre skripty a jednoduché nástroje, multi pre vysoko výkonné aplikácie. Pre vyšší programovací jazyk z rodiny C si pozrite curl do Rustu.

Ako riešiť autentifikáciu s libcurl?

Pre Bearer: nastavte vlastnú hlavičku pomocou curl_slist_append(headers, "Authorization: Bearer token"). Pre Basic auth: curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass"). libcurl automaticky kóduje prihlasovacie údaje pre Basic auth. curl2code konvertuje prepínače -u a hlavičky na správne volania C API.

Ako posielať multipart form data s libcurl?

Použite MIME API (libcurl 7.56+): curl_mime_init() na vytvorenie mime štruktúry, curl_mime_addpart() pre každé pole, curl_mime_name() a curl_mime_filedata() pre nahrávanie súborov. Nastavte pomocou CURLOPT_MIMEPOST. Uvoľnite pomocou curl_mime_free().

Ako riešiť chyby s libcurl?

Každá funkcia curl_easy_* vracia CURLcode — skontrolujte ho voči CURLE_OK. Použite curl_easy_strerror(code) pre ľudsky čitateľné správy. Nastavte CURLOPT_ERRORBUFFER pre podrobné chybové reťazce. Získajte HTTP stav pomocou curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code).

Ako spravovať pamäť s libcurl?

Vždy volajte curl_easy_cleanup(), keď skončíte s handlom. Uvoľnite zoznamy hlavičiek pomocou curl_slist_free_all(). Uvoľnite MIME štruktúry pomocou curl_mime_free(). Pre write callbacky spravujte vlastnú alokáciu buffera. Zavolajte curl_global_cleanup() raz pri ukončení programu. Neuvoľnenie zdrojov spôsobuje úniky pamäte.

Ako nastaviť timeouty s libcurl?

Nastavte CURLOPT_CONNECTTIMEOUT pre timeout pripojenia a CURLOPT_TIMEOUT pre celkový čas prenosu (obe v sekundách). Pre milisekundovú presnosť použite CURLOPT_CONNECTTIMEOUT_MS a CURLOPT_TIMEOUT_MS. Sú to presne tie isté voľby, ktoré používa curl CLI s --connect-timeout a --max-time.

Ako konfigurovať proxy s libcurl?

Nastavte CURLOPT_PROXY na URL proxy: curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080"). Pre SOCKS5: nastavte CURLOPT_PROXYTYPE na CURLPROXY_SOCKS5. Pre autentifikáciu proxy: CURLOPT_PROXYUSERPWD. libcurl tiež rešpektuje premennú prostredia http_proxy.

Ako poslať POST požiadavku s JSON telom v jazyku C?

Preveďte curl POST príkaz ako curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL do jazyka C pomocou curl2code. Vygenerovaný kód používa curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string). curl2code automaticky deteguje prepínače -d/--data s JSON obsahom a nastaví príslušnú hlavičku Content-Type v kóde pre libcurl.

Ako pridať autorizáciu pomocou Bearer tokenu v jazyku C?

Vložte curl -H "Authorization: Bearer YOUR_TOKEN" URL do curl2code a nástroj vygeneruje kód pre libcurl s autorizačnou hlavičkou: struct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN"). curl2code deteguje Bearer tokeny z prepínačov -H "Authorization: Bearer ..." aj --oauth2-bearer. Pre Basic auth použite -u user:pass.

Ako nastaviť hlavičku Content-Type v jazyku C?

curl2code konvertuje curl -H "Content-Type: application/json" URL na kód pre libcurl so správnou hlavičkou: curl_slist_append(headers, "Content-Type: application/json"). Pre dáta v -d curl predvolene používa application/x-www-form-urlencoded; pre nahrávanie formulárov cez -F používa multipart/form-data. curl2code mapuje každý z nich na správne API pre libcurl.

Užitočné odkazy

Dokumentácia libcurl

curl.se

Referencia štandardnej knižnice

curl.se

Manuálová stránka curl

curl.se

Príručky pre curl

Chybové kódy curl

Vyhľadajte ľubovoľný návratový kód curl — príčiny, opravy a tipy na ladenie.

Sťahovanie súborov pomocou curl

Ukladajte súbory s -o, -O, sledujte presmerovanie, obnovujte sťahovanie a ďalšie.

SSL, TLS a proxy

Konfigurácia certifikátov, verzií TLS, HTTP/SOCKS proxy a vlastného DNS.

Ako skopírovať curl z vášho prehliadača

Príklady kódu v C

1Jednoduchá GET požiadavka

2POST s JSON telom

3Požiadavka s Bearer tokenom

4Multipart Form nahrávanie

5Vlastné hlavičky

Často kladené otázky

Užitočné odkazy

Príručky pre curl

Prevod curl do iných jazykov

Príklady kódu v C

1Jednoduchá GET požiadavka

2POST s JSON telom

3Požiadavka s Bearer tokenom

4Multipart Form nahrávanie

5Vlastné hlavičky