Converter curl para MATLAB

Q: O que é o MATLAB webwrite?

As funções webwrite e webread do MATLAB fornecem capacidades HTTP nativas para enviar e receber dados. Gerem a serialização JSON automaticamente e integram-se com os tipos de dados do MATLAB. Para mais controlo, use matlab.net.http.RequestMessage. Não é necessária a instalação de toolboxes — estas fazem parte do núcleo do MATLAB.

Q: webwrite vs matlab.net.http — qual usar?

webwrite/webread são simples e concisos — ideais para chamadas de API rápidas e recuperação de dados. matlab.net.http fornece controlo total sobre cabeçalhos, métodos, streaming e autenticação. Use webwrite para chamadas REST padrão, e matlab.net.http quando precisar de cabeçalhos personalizados ou métodos não padrão. Para alternativas de ciência de dados, consulte curl para Python ou curl para R.

Q: Como gerir a autenticação em MATLAB?

Com weboptions: options = weboptions('HeaderFields', { 'Authorization', 'Bearer token' }). Para autenticação Basic, use weboptions('Username', user, 'Password', pass). Com matlab.net.http, defina os cabeçalhos diretamente em objetos HeaderField. O curl2code converte as flags de autenticação para a sintaxe MATLAB apropriada.

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

Use matlab.net.http.io.MultipartFormProvider para uploads de ficheiros. Para envios de formulários mais simples, use webwrite(url, 'key1', 'value1', 'key2', 'value2'). O MATLAB gere a serialização com base na opção MediaType. O curl2code converte as flags -F para o padrão MATLAB correto.

Q: Como gerir erros HTTP em MATLAB?

Envolva as chamadas em try/catch: try response = webread(url, options); catch ME disp(ME.message); end. Para verificação do código de estado com matlab.net.http, inspecione response.StatusCode. O MATLAB lança exceções em erros de rede e respostas não-2xx por padrão.

Q: Como analisar respostas JSON em MATLAB?

O webread analisa automaticamente o JSON em structs e cell arrays do MATLAB. Para análise manual, use jsondecode(jsonString). Converta dados do MATLAB para JSON com jsonencode(data). O MATLAB mapeia objetos JSON para structs, arrays para cell arrays e primitivos para os seus equivalentes MATLAB.

Q: Como definir timeouts em MATLAB?

Use weboptions('Timeout', 30) para definir o timeout em segundos. Com matlab.net.http, configure HTTPOptions com ConnectTimeout. O timeout padrão é de 5 segundos para webread/webwrite. Defina como Inf para nenhum timeout (não recomendado para produção).

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

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

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

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código webwrite com o cabeçalho de autenticação: options = weboptions('HeaderFields', {'Authorization', 'Bearer TOKEN'}). O curl2code deteta tokens Bearer tanto de flags -H "Authorization: Bearer ..." como de --oauth2-bearer. Para Basic auth, utilize -u user:pass.

O curl2code converte comandos curl para código MATLAB utilizando webwrite e webread. A conversão é executada no seu navegador através de WebAssembly para total privacidade. Para Python, consulte o nosso conversor de curl para Python. Para R, veja curl para R. Abaixo encontram-se exemplos práticos de MATLAB.

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 MATLAB

1Pedido GET Simples

comando curl

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

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/users';
response = webread(uri);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*

uri = URI('https://api.example.com/users');
response = RequestMessage().send(uri.EncodedURI);

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

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/users';
body = struct(...
    'name', 'John',...
    'email', 'john@example.com'...
);
options = weboptions('MediaType', 'application/json');
response = webwrite(uri, body, options);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*
import matlab.net.http.io.*

header = HeaderField('Content-Type', 'application/json');
uri = URI('https://api.example.com/users');
body = JSONProvider(struct(...
    'name', 'John',...
    'email', 'john@example.com'...
));
response = RequestMessage('post', header, body).send(uri.EncodedURI);

3Pedido com Bearer Token

comando curl

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

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/me';
options = weboptions('HeaderFields', {'Authorization' 'Bearer token123'});
response = webread(uri, options);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*

header = HeaderField('Authorization', 'Bearer token123');
uri = URI('https://api.example.com/me');
response = RequestMessage('get', header).send(uri.EncodedURI);

4Upload de Formulário Multipart

comando curl

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

MATLAB · webwrite

%% Web Access using Data Import and Export API
% This is not possible with the webread/webwrite API

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*
import matlab.net.http.io.*

uri = URI('https://api.example.com/upload');
body = MultipartFormProvider('file', FileProvider('document.pdf'), 'description', FormProvider('My file'));
response = RequestMessage('post', [], body).send(uri.EncodedURI);

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"

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/data';
options = weboptions(...
    'ContentType', 'json',...
    'HeaderFields', {
        'X-API-Key' 'abc123'
        'X-Request-ID' 'req-456'
    }...
);
response = webread(uri, options);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*

header = [
    HeaderField('X-API-Key', 'abc123')
    field.AcceptField(MediaType('application/json'))
    HeaderField('X-Request-ID', 'req-456')
]';
uri = URI('https://api.example.com/data');
response = RequestMessage('get', header).send(uri.EncodedURI);

Perguntas Frequentes

O que é o MATLAB webwrite?

As funções webwrite e webread do MATLAB fornecem capacidades HTTP nativas para enviar e receber dados. Gerem a serialização JSON automaticamente e integram-se com os tipos de dados do MATLAB. Para mais controlo, use matlab.net.http.RequestMessage. Não é necessária a instalação de toolboxes — estas fazem parte do núcleo do MATLAB.

webwrite vs matlab.net.http — qual usar?

webwrite/webread são simples e concisos — ideais para chamadas de API rápidas e recuperação de dados. matlab.net.http fornece controlo total sobre cabeçalhos, métodos, streaming e autenticação. Use webwrite para chamadas REST padrão, e matlab.net.http quando precisar de cabeçalhos personalizados ou métodos não padrão. Para alternativas de ciência de dados, consulte curl para Python ou curl para R.

Como gerir a autenticação em MATLAB?

Com weboptions: options = weboptions('HeaderFields', { 'Authorization', 'Bearer token' }). Para autenticação Basic, use weboptions('Username', user, 'Password', pass). Com matlab.net.http, defina os cabeçalhos diretamente em objetos HeaderField. O curl2code converte as flags de autenticação para a sintaxe MATLAB apropriada.

Como enviar dados de formulário multipart em MATLAB?

Use matlab.net.http.io.MultipartFormProvider para uploads de ficheiros. Para envios de formulários mais simples, use webwrite(url, 'key1', 'value1', 'key2', 'value2'). O MATLAB gere a serialização com base na opção MediaType. O curl2code converte as flags -F para o padrão MATLAB correto.

Como gerir erros HTTP em MATLAB?

Envolva as chamadas em try/catch: try response = webread(url, options); catch ME disp(ME.message); end. Para verificação do código de estado com matlab.net.http, inspecione response.StatusCode. O MATLAB lança exceções em erros de rede e respostas não-2xx por padrão.

Como analisar respostas JSON em MATLAB?

O webread analisa automaticamente o JSON em structs e cell arrays do MATLAB. Para análise manual, use jsondecode(jsonString). Converta dados do MATLAB para JSON com jsonencode(data). O MATLAB mapeia objetos JSON para structs, arrays para cell arrays e primitivos para os seus equivalentes MATLAB.

Como definir timeouts em MATLAB?

Use weboptions('Timeout', 30) para definir o timeout em segundos. Com matlab.net.http, configure HTTPOptions com ConnectTimeout. O timeout padrão é de 5 segundos para webread/webwrite. Defina como Inf para nenhum timeout (não recomendado para produção).

Como usar um proxy em MATLAB?

Configure o proxy nas preferências do MATLAB: Home > Preferences > Web. Ou use propriedades de sistema Java: java.lang.System.setProperty('http.proxyHost', 'proxy'). O MATLAB utiliza a stack de rede da JVM, pelo que as definições de proxy Java aplicam-se. Para autenticação de proxy, defina http.proxyUser e http.proxyPassword.

Como enviar um pedido POST com um corpo JSON em MATLAB?

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

Como adicionar autorização com token Bearer em MATLAB?

Passe curl -H "Authorization: Bearer YOUR_TOKEN" URL para o curl2code e este gera código webwrite com o cabeçalho de autenticação: options = weboptions('HeaderFields', {'Authorization', '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 MATLAB?

O curl2code converte curl -H "Content-Type: application/json" URL para código webwrite com o cabeçalho correto: options = weboptions('MediaType', '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 webwrite correta.

Links Úteis

Documentação do webwrite

mathworks.com

Referência da Biblioteca Padrão

mathworks.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 MATLAB

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 MATLAB

1Pedido GET Simples

2POST com Corpo JSON

3Pedido com Bearer Token

4Upload de Formulário Multipart

5Cabeçalhos Personalizados