Converter curl para Objective-C

Q: O que é o NSURLSession?

NSURLSession é a API da framework Foundation da Apple para redes HTTP em Objective-C (e Swift). Gere tarefas de dados, downloads, uploads e transferências em segundo plano. Disponível no iOS 7+, macOS 10.9+. Não é necessária nenhuma dependência de terceiros — é a forma padrão de fazer pedidos HTTP nas plataformas Apple. O curl2code gera código NSURLSession para Objective-C.

Q: NSURLSession vs AFNetworking — qual usar?

NSURLSession é a solução nativa — suficiente para a maioria das necessidades e com zero dependências. AFNetworking foi historicamente popular, mas está agora em modo de manutenção; o seu sucessor é o Alamofire (Swift). Para novos projetos Objective-C, recomenda-se o NSURLSession. Para Swift, consulte o nosso conversor de curl para Swift.

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

Defina o cabeçalho no NSMutableURLRequest: [request setValue:@"Bearer token" forHTTPHeaderField:@"Authorization"]. Para autenticação Basic, codifique as credenciais com NSData e base64EncodedStringWithOptions:. O curl2code converte as flags -u e Bearer para a sintaxe correta de Objective-C.

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

Construa o corpo multipart com NSMutableData: anexe as strings de boundary, dados de campos e dados de ficheiros com os separadores CRLF adequados. Defina o Content-Type com a boundary. Isto é manual, mas dá controlo total. O AFNetworking simplifica isto com o AFHTTPRequestSerializer.

Q: Como trabalhar com blocos de conclusão no NSURLSession?

O NSURLSession utiliza callbacks baseados em blocos: [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { ... }]. Chame sempre [task resume] para iniciar. Para pedidos sequenciais, aninhe blocos ou use grupos de despacho com dispatch_group_notify.

Q: Como definir timeouts em Objective-C?

Defina no NSURLSessionConfiguration: config.timeoutIntervalForRequest = 30 e config.timeoutIntervalForResource = 300. Ou por pedido: request.timeoutInterval = 30. Os erros de timeout chegam como NSURLErrorTimedOut no parâmetro de erro. Estes mapeiam para a opção --max-time do curl.

Q: Como usar um proxy com NSURLSession?

Defina connectionProxyDictionary no NSURLSessionConfiguration com chaves como (NSString *)kCFNetworkProxiesHTTPProxy e a porta. O NSURLSession respeita as definições de proxy de todo o sistema por padrão no macOS e iOS. Para ficheiros PAC, configure através das preferências do sistema.

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

Converta um comando curl POST como curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL para Objective-C usando o curl2code. O código gerado utiliza [request setHTTPBody:[NSJSONSerialization dataWithJSONObject:dict options:0 error:nil]]. O curl2code deteta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código NSURLSession.

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

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código NSURLSession com o cabeçalho de autenticação: [request setValue:@"Bearer TOKEN" forHTTPHeaderField:@"Authorization"]. 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 Objective-C utilizando NSURLSession. O curl2code é executado inteiramente no seu navegador através de WebAssembly — os seus dados permanecem privados. Para Swift, experimente o nosso conversor de curl para Swift. Para C, veja curl para C. Abaixo encontram-se exemplos de Objective-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 Objective-C

1Pedido GET Simples

comando curl

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

Objective-C · NSURLSession

#import <Foundation/Foundation.h>

NSURL *url = [NSURL URLWithString:@"https://api.example.com/users"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];

NSURLSessionConfiguration *defaultSessionConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:defaultSessionConfiguration];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (error) {
        NSLog(@"%@", error);
    } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSLog(@"%@", httpResponse);
    }
}];
[dataTask resume];

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"}'

Objective-C · NSURLSession

#import <Foundation/Foundation.h>

NSURL *url = [NSURL URLWithString:@"https://api.example.com/users"];
NSDictionary *headers = @{
    @"Content-Type": @"application/json"
};

NSMutableData *data = [[NSMutableData alloc] initWithData:[@"{\"name\":\"John\",\"email\":\"john@example.com\"}" dataUsingEncoding:NSUTF8StringEncoding]];

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"POST"];
[request setAllHTTPHeaderFields:headers];
[request setHTTPBody:data];

NSURLSessionConfiguration *defaultSessionConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:defaultSessionConfiguration];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (error) {
        NSLog(@"%@", error);
    } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSLog(@"%@", httpResponse);
    }
}];
[dataTask resume];

3Pedido com Bearer Token

comando curl

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

Objective-C · NSURLSession

#import <Foundation/Foundation.h>

NSURL *url = [NSURL URLWithString:@"https://api.example.com/me"];
NSDictionary *headers = @{
    @"Authorization": @"Bearer token123"
};

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setAllHTTPHeaderFields:headers];

NSURLSessionConfiguration *defaultSessionConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:defaultSessionConfiguration];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (error) {
        NSLog(@"%@", error);
    } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSLog(@"%@", httpResponse);
    }
}];
[dataTask resume];

4Upload de Formulário Multipart

comando curl

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

Objective-C · NSURLSession

#import <Foundation/Foundation.h>

NSURL *url = [NSURL URLWithString:@"https://api.example.com/upload"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"POST"];

NSURLSessionConfiguration *defaultSessionConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:defaultSessionConfiguration];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (error) {
        NSLog(@"%@", error);
    } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSLog(@"%@", httpResponse);
    }
}];
[dataTask resume];

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"

Objective-C · NSURLSession

#import <Foundation/Foundation.h>

NSURL *url = [NSURL URLWithString:@"https://api.example.com/data"];
NSDictionary *headers = @{
    @"X-API-Key": @"abc123",
    @"Accept": @"application/json",
    @"X-Request-ID": @"req-456"
};

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setAllHTTPHeaderFields:headers];

NSURLSessionConfiguration *defaultSessionConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:defaultSessionConfiguration];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (error) {
        NSLog(@"%@", error);
    } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSLog(@"%@", httpResponse);
    }
}];
[dataTask resume];

Perguntas Frequentes

O que é o NSURLSession?

NSURLSession é a API da framework Foundation da Apple para redes HTTP em Objective-C (e Swift). Gere tarefas de dados, downloads, uploads e transferências em segundo plano. Disponível no iOS 7+, macOS 10.9+. Não é necessária nenhuma dependência de terceiros — é a forma padrão de fazer pedidos HTTP nas plataformas Apple. O curl2code gera código NSURLSession para Objective-C.

NSURLSession vs AFNetworking — qual usar?

NSURLSession é a solução nativa — suficiente para a maioria das necessidades e com zero dependências. AFNetworking foi historicamente popular, mas está agora em modo de manutenção; o seu sucessor é o Alamofire (Swift). Para novos projetos Objective-C, recomenda-se o NSURLSession. Para Swift, consulte o nosso conversor de curl para Swift.

Como gerir a autenticação em Objective-C?

Defina o cabeçalho no NSMutableURLRequest: [request setValue:@"Bearer token" forHTTPHeaderField:@"Authorization"]. Para autenticação Basic, codifique as credenciais com NSData e base64EncodedStringWithOptions:. O curl2code converte as flags -u e Bearer para a sintaxe correta de Objective-C.

Como enviar dados de formulário multipart em Objective-C?

Construa o corpo multipart com NSMutableData: anexe as strings de boundary, dados de campos e dados de ficheiros com os separadores CRLF adequados. Defina o Content-Type com a boundary. Isto é manual, mas dá controlo total. O AFNetworking simplifica isto com o AFHTTPRequestSerializer.

Como gerir erros HTTP em Objective-C?

Os completion handlers do NSURLSession fornecem um parâmetro NSError — verifique-o para erros de rede/transporte. Converta a resposta para NSHTTPURLResponse e verifique o statusCode. Use os métodos delegados do NSURLSession para uma gestão de erros mais granular, incluindo desafios de autenticação e redirecionamentos.

Como trabalhar com blocos de conclusão no NSURLSession?

O NSURLSession utiliza callbacks baseados em blocos: [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { ... }]. Chame sempre [task resume] para iniciar. Para pedidos sequenciais, aninhe blocos ou use grupos de despacho com dispatch_group_notify.

Como definir timeouts em Objective-C?

Defina no NSURLSessionConfiguration: config.timeoutIntervalForRequest = 30 e config.timeoutIntervalForResource = 300. Ou por pedido: request.timeoutInterval = 30. Os erros de timeout chegam como NSURLErrorTimedOut no parâmetro de erro. Estes mapeiam para a opção --max-time do curl.

Como usar um proxy com NSURLSession?

Defina connectionProxyDictionary no NSURLSessionConfiguration com chaves como (NSString *)kCFNetworkProxiesHTTPProxy e a porta. O NSURLSession respeita as definições de proxy de todo o sistema por padrão no macOS e iOS. Para ficheiros PAC, configure através das preferências do sistema.

Como enviar um pedido POST com um corpo JSON em Objective-C?

Converta um comando curl POST como curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL para Objective-C usando o curl2code. O código gerado utiliza [request setHTTPBody:[NSJSONSerialization dataWithJSONObject:dict options:0 error:nil]]. O curl2code deteta automaticamente as flags -d/--data com conteúdo JSON e define o cabeçalho Content-Type apropriado no código NSURLSession.

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

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código NSURLSession com o cabeçalho de autenticação: [request setValue:@"Bearer TOKEN" forHTTPHeaderField:@"Authorization"]. 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 Objective-C?

O curl2code converte curl -H "Content-Type: application/json" URL para código NSURLSession com o cabeçalho correto: [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"]. 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 NSURLSession correta.

Links Úteis

Documentação do NSURLSession

developer.apple.com

Referência da Biblioteca Padrão

github.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 Objective-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 Objective-C

1Pedido GET Simples

2POST com Corpo JSON

3Pedido com Bearer Token

4Upload de Formulário Multipart

5Cabeçalhos Personalizados