Converter curl para C#

Q: O que é o HttpClient do C#?

O HttpClient é o cliente HTTP moderno e integrado no .NET. Suporta async/await nativamente, HTTP/2, descompressão automática e pooling de ligações. Use uma única instância de HttpClient (ou IHttpClientFactory) em toda a sua aplicação para evitar a exaustão de sockets. É a biblioteca predefinida e única que o curl2code usa para conversões em C#.

Q: HttpClient vs WebClient vs HttpWebRequest — qual usar?

O HttpClient é o padrão moderno — use-o sempre para novos projetos .NET. O WebClient e o HttpWebRequest são legados e não devem ser usados em código novo. O HttpClient fornece suporte assíncrono, melhor desempenho e uma API mais limpa. Para clientes modernos semelhantes, consulte curl para Java ou curl para Go.

Q: Como gerir a autenticação em C#?

Defina o cabeçalho: client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token). Para autenticação Basic, codifique as credenciais e defina o cabeçalho. A autenticação por pedido usa request.Headers.Authorization. O curl2code deteta -u e -H 'Authorization' e gera o código C# correto.

Q: Como enviar dados de formulário multipart em C#?

Use MultipartFormDataContent: adicione StringContent para campos e StreamContent com ContentDisposition para ficheiros. Passe o conteúdo multipart para PostAsync(url, content). O limite de Content-Type é definido automaticamente. O curl2code converte as flags -F para este padrão.

Q: Como gerir erros HTTP em C#?

Chame response.EnsureSuccessStatusCode() para lançar HttpRequestException em estados não-2xx. Ou verifique response.IsSuccessStatusCode e response.StatusCode manualmente. Envolva em try/catch para HttpRequestException, TaskCanceledException (timeout) e OperationCanceledException.

Q: Como definir timeouts no HttpClient do C#?

Defina client.Timeout = TimeSpan.FromSeconds(30) para o timeout global. Para controlo por pedido, use CancellationTokenSource com um timeout: new CancellationTokenSource(TimeSpan.FromSeconds(10)). Para tentativas, use a biblioteca Polly ou IHttpClientFactory com políticas de retry.

Q: Como configurar um proxy em C#?

Crie um HttpClientHandler com proxy: handler.Proxy = new WebProxy("http://proxy:8080"). Passe o handler para new HttpClient(handler). Para ignorar o proxy para endereços locais, defina handler.Proxy.BypassProxyOnLocal = true. O curl2code converte as flags -x e --proxy para esta configuração.

Q: Como enviar um pedido POST com um corpo JSON em C#?

Converta um comando curl POST como curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL para C# usando o curl2code. O código gerado utiliza new StringContent(json, Encoding.UTF8, 'application/json'). O curl2code deteta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código HttpClient.

Q: Como adicionar autorização com token Bearer em C#?

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código HttpClient com o cabeçalho de autenticação: client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue('Bearer', token). O curl2code deteta tokens Bearer tanto de flags -H "Authorization: Bearer ..." como de --oauth2-bearer. Para Basic auth, utilize -u user:pass.

Converta comandos curl para código C# utilizando HttpClient. O curl2code é executado inteiramente no seu navegador através de WebAssembly — os seus dados permanecem privados. Para desenvolvimento em Java, experimente o nosso conversor de curl para Java. Para TypeScript, veja curl para TypeScript. Abaixo encontram-se exemplos de C# prontos a usar.

Como copiar o curl do seu navegador

1
Abrir as DevTools
Prima F12 ou Ctrl+Shift+I para abrir as ferramentas de programador do seu navegador.
2
Ir para o separador Network
Clique no separador Network e realize a ação que despoleta o pedido HTTP.
3
Copiar como cURL
Clique com o botão direito no pedido → Copy → Copy as cURL. Depois cole-o acima.

Exemplos de Código C#

1Pedido GET Simples

comando curl

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

C# · HttpClient

HttpClient client = new HttpClient();

string responseBody = await client.GetStringAsync("https://api.example.com/users");

2POST com Corpo JSON

comando curl

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

C# · HttpClient

using System.Net.Http;
using System.Net.Http.Headers;

HttpClient client = new HttpClient();

HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, "https://api.example.com/users");
request.Content = new StringContent("{\"name\":\"John\",\"email\":\"john@example.com\"}");
request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");

HttpResponseMessage response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();

3Pedido com Bearer Token

comando curl

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

C# · HttpClient

using System.Net.Http;

HttpClient client = new HttpClient();

HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, "https://api.example.com/me");

request.Headers.Add("Authorization", "Bearer token123");

HttpResponseMessage response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();

4Upload de Formulário Multipart

comando curl

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

C# · HttpClient

using System.Net.Http;

HttpClient client = new HttpClient();

HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, "https://api.example.com/upload");

MultipartFormDataContent content = new MultipartFormDataContent();
content.Add(new ByteArrayContent(File.ReadAllBytes("document.pdf")), "file", Path.GetFileName("document.pdf"));
content.Add(new StringContent("My file"), "description");
request.Content = content;

HttpResponseMessage response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();

5Cabeçalhos Personalizados

comando curl

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

C# · HttpClient

using System.Net.Http;

HttpClient client = new HttpClient();

HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, "https://api.example.com/data");

request.Headers.Add("X-API-Key", "abc123");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("X-Request-ID", "req-456");

HttpResponseMessage response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();

Perguntas Frequentes

O que é o HttpClient do C#?

O HttpClient é o cliente HTTP moderno e integrado no .NET. Suporta async/await nativamente, HTTP/2, descompressão automática e pooling de ligações. Use uma única instância de HttpClient (ou IHttpClientFactory) em toda a sua aplicação para evitar a exaustão de sockets. É a biblioteca predefinida e única que o curl2code usa para conversões em C#.

HttpClient vs WebClient vs HttpWebRequest — qual usar?

O HttpClient é o padrão moderno — use-o sempre para novos projetos .NET. O WebClient e o HttpWebRequest são legados e não devem ser usados em código novo. O HttpClient fornece suporte assíncrono, melhor desempenho e uma API mais limpa. Para clientes modernos semelhantes, consulte curl para Java ou curl para Go.

Como gerir a autenticação em C#?

Defina o cabeçalho: client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token). Para autenticação Basic, codifique as credenciais e defina o cabeçalho. A autenticação por pedido usa request.Headers.Authorization. O curl2code deteta -u e -H 'Authorization' e gera o código C# correto.

Como enviar dados de formulário multipart em C#?

Use MultipartFormDataContent: adicione StringContent para campos e StreamContent com ContentDisposition para ficheiros. Passe o conteúdo multipart para PostAsync(url, content). O limite de Content-Type é definido automaticamente. O curl2code converte as flags -F para este padrão.

Como gerir erros HTTP em C#?

Chame response.EnsureSuccessStatusCode() para lançar HttpRequestException em estados não-2xx. Ou verifique response.IsSuccessStatusCode e response.StatusCode manualmente. Envolva em try/catch para HttpRequestException, TaskCanceledException (timeout) e OperationCanceledException.

Como usar async/await com o HttpClient?

O HttpClient é assíncrono por design — todos os métodos devolvem Task: var response = await client.GetAsync(url). Use await response.Content.ReadAsStringAsync() para o corpo. Para pedidos paralelos, use Task.WhenAll(). Nunca use .Result ou .Wait() — podem causar deadlocks. Para padrões assíncronos semelhantes, consulte curl para TypeScript.

Como definir timeouts no HttpClient do C#?

Defina client.Timeout = TimeSpan.FromSeconds(30) para o timeout global. Para controlo por pedido, use CancellationTokenSource com um timeout: new CancellationTokenSource(TimeSpan.FromSeconds(10)). Para tentativas, use a biblioteca Polly ou IHttpClientFactory com políticas de retry.

Como configurar um proxy em C#?

Crie um HttpClientHandler com proxy: handler.Proxy = new WebProxy("http://proxy:8080"). Passe o handler para new HttpClient(handler). Para ignorar o proxy para endereços locais, defina handler.Proxy.BypassProxyOnLocal = true. O curl2code converte as flags -x e --proxy para esta configuração.

Como enviar um pedido POST com um corpo JSON em C#?

Converta um comando curl POST como curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL para C# usando o curl2code. O código gerado utiliza new StringContent(json, Encoding.UTF8, 'application/json'). O curl2code deteta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código HttpClient.

Como adicionar autorização com token Bearer em C#?

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código HttpClient com o cabeçalho de autenticação: client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue('Bearer', token). O curl2code deteta tokens Bearer tanto de flags -H "Authorization: Bearer ..." como de --oauth2-bearer. Para Basic auth, utilize -u user:pass.

Como definir o cabeçalho Content-Type em C#?

O curl2code converte curl -H "Content-Type: application/json" URL para código HttpClient com o cabeçalho correto: new StringContent(json, Encoding.UTF8, 'application/json'). Para dados -d, o curl assume por defeito application/x-www-form-urlencoded; para envios de formulários -F, utiliza multipart/form-data. O curl2code mapeia cada um para a API HttpClient correta.

Links Úteis

Documentação do HttpClient

learn.microsoft.com

Referência da Biblioteca Padrão

learn.microsoft.com

Página Man do curl

curl.se

Guias do curl

Códigos de erro do curl

Consulte qualquer código de saída do curl — causas, correções e dicas de depuração.

Transferir ficheiros com curl

Guarde ficheiros com -o, -O, siga redirecionamentos, retome transferências e mais.

SSL, TLS e proxy

Configure certificados, versões TLS, proxies HTTP/SOCKS e DNS personalizado.

Como copiar o curl do seu navegador

Exemplos de Código C#

1Pedido GET Simples

2POST com Corpo JSON

3Pedido com Bearer Token

4Upload de Formulário Multipart

5Cabeçalhos Personalizados

Perguntas Frequentes

Links Úteis

Guias do curl

Converter curl para Outras Linguagens

Exemplos de Código C#

1Pedido GET Simples

2POST com Corpo JSON

3Pedido com Bearer Token

4Upload de Formulário Multipart

5Cabeçalhos Personalizados